@rex0220/formula-authoring-tools 0.2.0 → 0.2.1

package/README.md

@@ -59,5 +59,6 @@ npm pack --dry-run  # 公開前に中身を確かめる（dist、vendor、LICENS
 
 ## 履歴
 
+- 0.2.1（2026-10）: formula MCP の Codex レビューへの対応。`updateFields` の `common` を共通の設定のキー（`COMMON_KEYS`）だけに。Worker の中の誤りの種類（`EvalError.kind`）と名前を中核が instanceof で決める（zip のコードの例外の name / constructor.name / 文を応答や標準エラーに出さない。`classifyEvalError` / `builtinErrorName`）。保存の結果の想定外の誤りも種類だけ（`zipCode`）。CLI の想定外の誤りは種類だけ（`FORMULA_DEBUG=1` で文とスタック）。接続の誤りの文の print-craft の名残を直した
 - 0.2.0（2026-10）: formula MCP のための中核の入口（`CORE_API_VERSION` 2。CLI の動きは変えない）。`core` に workspace / connections / permission / commit-file / take / users の参照コード / JSON の誤りの文 / 行のキーを追加。`src/commands/save.ts`（`saveNewSettings` / `updateFields`）。`runEval` の `workerFile`（Worker の入口の絶対パス）と `captureOutput`（Worker の標準出力・標準エラーを親に流さず受け取る）、`loadEngine` の `vendorDir`（moment の置き場所）。評価の結果に `findings` と calc のレコードごとの行
 - 0.1.0（2026-10）: 最初の公開。version / fields / record / records / pull / summary / diff / users / normalize / calc / take / edit / files。扱う計算式プラグイン Ver.101 以降、authoring API 1

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/*! @rex0220/formula-authoring-tools 0.2.0 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit 1e50847. */
+/*! @rex0220/formula-authoring-tools 0.2.1 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit f2e46ef. */
 
 // src/cli.ts
 import { chmodSync, existsSync as existsSync9, mkdirSync as mkdirSync2, realpathSync as realpathSync5, writeFileSync as writeFileSync3 } from "node:fs";
@@ -355,7 +355,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.2.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"1e50847","builtAt":"2026-10-18T02:11:59.644Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.2.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"f2e46ef","builtAt":"2026-10-18T03:55:45.474Z","mode":"build"}');
   return devMeta();
 }
 
@@ -1401,7 +1401,7 @@ function authFor(set, profile, appId) {
   if (value === void 0) throw new ConnectionError(`profile「${profile.profile}」の tokenMap に APP${appId} が無い（そのアプリの API トークンを足す）`, "no-token");
   if (value.startsWith("env:")) {
     const token = nonblank(held.env[value.slice(4)]);
-    if (!token) throw new ConnectionError(`profile「${profile.profile}」の APP${appId} のトークンの環境変数が無い（設定した後、print-craft を再接続する。Desktop は起動し直す）`, "env-missing");
+    if (!token) throw new ConnectionError(`profile「${profile.profile}」の APP${appId} のトークンの環境変数が無い（環境変数を置いてから実行し直す。MCP なら再接続する: Claude Code は /mcp、Desktop は起動し直す）`, "env-missing");
     return { baseUrl: profile.baseUrl, token };
   }
   return { baseUrl: profile.baseUrl, token: value };
@@ -3079,6 +3079,22 @@ function calcSettings(input) {
 }
 
 // src/worker/eval-run.ts
+function classifyEvalError(e) {
+  const message = String(e?.message ?? e);
+  if (e instanceof InputError) return { kind: "input", name: "InputError", message };
+  if (e instanceof PluginZipError) return { kind: "zip", name: "PluginZipError", message, code: e.code };
+  if (e instanceof UsersDataError) return { kind: "users", name: "UsersDataError", message };
+  if (e instanceof PolicyError) return { kind: "policy", name: "PolicyError", message };
+  return { kind: "other", name: builtinErrorName(e), message };
+}
+function builtinErrorName(e) {
+  if (e instanceof TypeError) return "TypeError";
+  if (e instanceof RangeError) return "RangeError";
+  if (e instanceof ReferenceError) return "ReferenceError";
+  if (e instanceof SyntaxError) return "SyntaxError";
+  if (e instanceof URIError) return "URIError";
+  return "Error";
+}
 async function runEvalJob(job) {
   const engine = await loadEngine({ pluginZip: job.pluginZip, devPluginDir: job.devPluginDir, mode: job.mode, vendorDir: job.vendorDir });
   if (job.baseUrl) engine.setContext({ baseUrl: job.baseUrl });
@@ -3137,10 +3153,12 @@ var EvalTimeoutError = class extends Error {
 var EvalError = class extends Error {
   innerName;
   code;
-  constructor(message, innerName, code) {
+  kind;
+  constructor(message, innerName, code, kind = "other") {
     super(message);
     this.innerName = innerName;
     this.code = code;
+    this.kind = kind;
   }
 };
 function workerEntry() {
@@ -3154,7 +3172,14 @@ function workerEntry() {
 }
 async function runEval(job, opt = {}) {
   const timeoutSec = Math.min(Math.max(opt.timeoutSec ?? DEFAULT_TIMEOUT_SEC, 1), MAX_TIMEOUT_SEC);
-  if (opt.inline) return runEvalJob(job);
+  if (opt.inline) {
+    try {
+      return await runEvalJob(job);
+    } catch (e) {
+      const c = classifyEvalError(e);
+      throw new EvalError(c.message, c.name, c.code, c.kind);
+    }
+  }
   let entry;
   if (opt.workerFile !== void 0) {
     if (!path13.isAbsolute(opt.workerFile) || !existsSync8(opt.workerFile)) throw new Error(`Worker の入口が無い（絶対パスで指定する）: ${opt.workerFile}`);
@@ -3183,10 +3208,10 @@ async function runEval(job, opt = {}) {
     worker.on("message", (m) => {
       finish(() => {
         if (m.ok) resolve(m.outcome);
-        else reject(new EvalError(m.error.message, m.error.name, m.error.code));
+        else reject(new EvalError(m.error.message, m.error.name, m.error.code, m.error.kind ?? "other"));
       });
     });
-    worker.on("error", (e) => finish(() => reject(e)));
+    worker.on("error", (e) => finish(() => reject(new EvalError(e?.message ?? String(e), builtinErrorName(e), void 0, "other"))));
     worker.on("exit", (code) => finish(() => reject(new Error(`評価の Worker が結果を返さずに終わった（exit ${code}）`))));
   });
 }
@@ -3792,13 +3817,18 @@ ${USAGE}`);
       return 1;
     }
     if (e instanceof EvalError) {
-      if (["PluginZipError", "InputError", "UsersDataError", "PolicyError", "AuthError"].includes(e.innerName)) {
+      if (e.kind !== "other") {
         console.error(e.message);
         return 1;
       }
-      throw new Error(`${e.innerName}: ${e.message}`);
+      console.error(`評価の途中で想定外の誤り（${e.innerName}）。誤りの文は値を含みうるので表示しない（FORMULA_DEBUG=1 で表示）。normalize で設定を、version で zip を確かめる`);
+      if (W.env.FORMULA_DEBUG === "1") console.error(e.message);
+      return 1;
     }
-    throw e;
+    const name = builtinErrorName(e);
+    console.error(`想定外の誤り（${name}）。誤りの文は値を含みうるので表示しない（FORMULA_DEBUG=1 で表示）`);
+    if (W.env.FORMULA_DEBUG === "1") console.error(e instanceof Error ? e.stack ?? e.message : String(e));
+    return 1;
   }
 }
 var invokedRaw = process.argv[1] ? path14.resolve(process.argv[1]) : "";
@@ -3817,6 +3847,9 @@ try {
 if (invoked && (invoked === self || /[\\/]dist[\\/]cli\.mjs$/.test(invoked))) {
   main(process.argv.slice(2)).then((code) => {
     process.exitCode = code;
+  }, (e) => {
+    console.error(`想定外の誤り（${builtinErrorName(e)}）`);
+    process.exitCode = 1;
   });
 }
 export {

package/dist/core.mjs

@@ -1,4 +1,4 @@
-/*! @rex0220/formula-authoring-tools/core 0.2.0 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit 1e50847. */
+/*! @rex0220/formula-authoring-tools/core 0.2.1 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit f2e46ef. */
 
 // src/safe-path.ts
 import { lstatSync, realpathSync } from "node:fs";
@@ -190,7 +190,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.2.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"1e50847","builtAt":"2026-10-18T02:11:59.644Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.2.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"f2e46ef","builtAt":"2026-10-18T03:55:45.474Z","mode":"build"}');
   return devMeta();
 }
 
@@ -2649,7 +2649,7 @@ function authFor(set, profile, appId) {
   if (value === void 0) throw new ConnectionError(`profile「${profile.profile}」の tokenMap に APP${appId} が無い（そのアプリの API トークンを足す）`, "no-token");
   if (value.startsWith("env:")) {
     const token = nonblank(held.env[value.slice(4)]);
-    if (!token) throw new ConnectionError(`profile「${profile.profile}」の APP${appId} のトークンの環境変数が無い（設定した後、print-craft を再接続する。Desktop は起動し直す）`, "env-missing");
+    if (!token) throw new ConnectionError(`profile「${profile.profile}」の APP${appId} のトークンの環境変数が無い（環境変数を置いてから実行し直す。MCP なら再接続する: Claude Code は /mcp、Desktop は起動し直す）`, "env-missing");
     return { baseUrl: profile.baseUrl, token };
   }
   return { baseUrl: profile.baseUrl, token: value };
@@ -3227,6 +3227,22 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 import path13 from "node:path";
 
 // src/worker/eval-run.ts
+function classifyEvalError(e) {
+  const message = String(e?.message ?? e);
+  if (e instanceof InputError) return { kind: "input", name: "InputError", message };
+  if (e instanceof PluginZipError) return { kind: "zip", name: "PluginZipError", message, code: e.code };
+  if (e instanceof UsersDataError) return { kind: "users", name: "UsersDataError", message };
+  if (e instanceof PolicyError) return { kind: "policy", name: "PolicyError", message };
+  return { kind: "other", name: builtinErrorName(e), message };
+}
+function builtinErrorName(e) {
+  if (e instanceof TypeError) return "TypeError";
+  if (e instanceof RangeError) return "RangeError";
+  if (e instanceof ReferenceError) return "ReferenceError";
+  if (e instanceof SyntaxError) return "SyntaxError";
+  if (e instanceof URIError) return "URIError";
+  return "Error";
+}
 async function runEvalJob(job) {
   const engine = await loadEngine({ pluginZip: job.pluginZip, devPluginDir: job.devPluginDir, mode: job.mode, vendorDir: job.vendorDir });
   if (job.baseUrl) engine.setContext({ baseUrl: job.baseUrl });
@@ -3285,10 +3301,12 @@ var EvalTimeoutError = class extends Error {
 var EvalError = class extends Error {
   innerName;
   code;
-  constructor(message, innerName, code) {
+  kind;
+  constructor(message, innerName, code, kind = "other") {
     super(message);
     this.innerName = innerName;
     this.code = code;
+    this.kind = kind;
   }
 };
 function workerEntry() {
@@ -3302,7 +3320,14 @@ function workerEntry() {
 }
 async function runEval(job, opt = {}) {
   const timeoutSec = Math.min(Math.max(opt.timeoutSec ?? DEFAULT_TIMEOUT_SEC, 1), MAX_TIMEOUT_SEC);
-  if (opt.inline) return runEvalJob(job);
+  if (opt.inline) {
+    try {
+      return await runEvalJob(job);
+    } catch (e) {
+      const c = classifyEvalError(e);
+      throw new EvalError(c.message, c.name, c.code, c.kind);
+    }
+  }
   let entry;
   if (opt.workerFile !== void 0) {
     if (!path13.isAbsolute(opt.workerFile) || !existsSync7(opt.workerFile)) throw new Error(`Worker の入口が無い（絶対パスで指定する）: ${opt.workerFile}`);
@@ -3331,10 +3356,10 @@ async function runEval(job, opt = {}) {
     worker.on("message", (m) => {
       finish2(() => {
         if (m.ok) resolve(m.outcome);
-        else reject(new EvalError(m.error.message, m.error.name, m.error.code));
+        else reject(new EvalError(m.error.message, m.error.name, m.error.code, m.error.kind ?? "other"));
       });
     });
-    worker.on("error", (e) => finish2(() => reject(e)));
+    worker.on("error", (e) => finish2(() => reject(new EvalError(e?.message ?? String(e), builtinErrorName(e), void 0, "other"))));
     worker.on("exit", (code) => finish2(() => reject(new Error(`評価の Worker が結果を返さずに終わった（exit ${code}）`))));
   });
 }
@@ -3342,6 +3367,7 @@ async function runEval(job, opt = {}) {
 // src/commands/save.ts
 var MAX_SAVE_INPUT_BYTES = 256 * 1024;
 var MAX_UPDATE_ROWS = 50;
+var COMMON_KEYS2 = ["pluginEnable", "pluginProductEnv", "toolEnable", "pluginComment", "pluginDescription", "pluginBtnInfo", "pluginListInfo", "authority", "pluginMiscInfo"];
 function digestOf(text) {
   return createHash4("sha256").update(text).digest("hex");
 }
@@ -3430,7 +3456,7 @@ function statusOf(e) {
   if (e instanceof ConflictError || e instanceof FileExistsError || e instanceof LockBusyError) return "conflict";
   if (e instanceof SaveDenied || e instanceof PermissionError || e instanceof PathError) return "denied";
   if (e instanceof InputError || e instanceof SyntaxError) return "invalid";
-  if (e instanceof EvalError && e.innerName === "InputError") return "invalid";
+  if (e instanceof EvalError && e.kind === "input") return "invalid";
   return "failed";
 }
 function connectionStatusOf(e) {
@@ -3453,12 +3479,20 @@ function codeOf(e) {
   if (e instanceof ConnectionError) return e.code;
   if (e instanceof ConflictError || e instanceof FileExistsError || e instanceof LockBusyError) return "ConflictError";
   if (e instanceof SaveDenied || e instanceof PermissionError) return "PermissionError";
-  if (e instanceof EvalError) return e.innerName;
+  if (e instanceof EvalError) return { input: "InputError", zip: "PluginZipError", users: "UsersDataError", policy: "PolicyError", other: e.innerName }[e.kind];
   if (e instanceof EvalTimeoutError) return "EvalTimeoutError";
-  return e instanceof Error ? e.constructor.name : "Error";
+  if (e instanceof InputError) return "InputError";
+  if (e instanceof PathError) return "PathError";
+  return builtinErrorName(e);
+}
+function safeMessageOf(e) {
+  if (e instanceof ConnectionError || e instanceof ConflictError || e instanceof FileExistsError || e instanceof LockBusyError || e instanceof SaveDenied || e instanceof PermissionError || e instanceof PathError || e instanceof InputError || e instanceof EvalTimeoutError) return e.message;
+  if (e instanceof EvalError) return e.kind === "other" ? `評価の途中で想定外の誤り（${e.innerName}）。誤りの文は値やパスを含みうるので返さない` : e.message;
+  if (e instanceof SyntaxError) return "JSON の構文の誤り（中身は返さない）";
+  return `想定外の誤り（${builtinErrorName(e)}）。誤りの文は値やパスを含みうるので返さない`;
 }
 function errorResult(root, target, e, findings = []) {
-  return { status: statusOf(e), code: codeOf(e), path: rel(root, target), findings, message: e instanceof Error ? e.message : String(e) };
+  return { status: statusOf(e), code: codeOf(e), path: rel(root, target), findings, message: safeMessageOf(e), ...e instanceof EvalError && e.kind === "zip" && e.code ? { zipCode: e.code } : {} };
 }
 function finish(ctx, target, outcome, run, extra = {}) {
   const findings = outcome.normalize.findings;
@@ -3532,9 +3566,11 @@ function parseRows(text, current) {
 }
 function parseCommon(text) {
   const v = parseInput(text, "common");
-  if (!isPlainObject2(v)) throw new InputError("common は最上位のキー（pluginMiscInfo、pluginListInfo、authority、pluginEnable など）を持つオブジェクト");
-  const bad = Object.keys(v).filter((k) => k === "pluginInfos" || ENVELOPE_KEYS2.includes(k));
-  if (bad.length) throw new InputError(`common で変えられないキー: ${bad.join(", ")}（項目の行は rows、封筒（appId など）は変えない）`);
+  if (!isPlainObject2(v)) throw new InputError(`common は共通の設定のキー（${COMMON_KEYS2.join("、")}）を持つオブジェクト`);
+  const fixed = Object.keys(v).filter((k) => k === "pluginInfos" || ENVELOPE_KEYS2.includes(k));
+  if (fixed.length) throw new InputError(`common で変えられないキー: ${fixed.join(", ")}（項目の行は rows、封筒（appId など）は変えない）`);
+  const unknown = Object.keys(v).filter((k) => !COMMON_KEYS2.includes(k));
+  if (unknown.length) throw new InputError(`common に共通の設定でないキーがある: ${unknown.join(", ")}（使えるのは ${COMMON_KEYS2.join("、")}）`);
   if (!Object.keys(v).length) throw new InputError("common が空（変えないなら渡さない）");
   return v;
 }
@@ -3607,6 +3643,7 @@ export {
   ALLOWED_USER_APIS,
   APP_MARKER,
   AuthError,
+  COMMON_KEYS2 as COMMON_KEYS,
   CONNECTION_MAX_BYTES,
   CORE_API_VERSION,
   ConnectionError,
@@ -3679,8 +3716,10 @@ export {
   baseUrlFromEnv,
   bodyOf,
   buildUsersInfo,
+  builtinErrorName,
   calcSettings,
   classOfAppPath,
+  classifyEvalError,
   cleanupAll,
   connectionStatusOf,
   contextTargetsOf,

package/dist/eval-worker.mjs

@@ -93,7 +93,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.2.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"1e50847","builtAt":"2026-10-18T02:11:59.644Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.2.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"f2e46ef","builtAt":"2026-10-18T03:55:45.474Z","mode":"build"}');
   return devMeta();
 }
 
@@ -326,6 +326,8 @@ var DEFAULT_USERS = {
 };
 
 // src/users/index.ts
+var UsersDataError = class extends Error {
+};
 function buildUsersInfo(src) {
   const t = { users: [], organizations: [], groups: [], userCodes: {}, orgCodes: {}, groupCodes: {}, userIds: {}, orgIds: {}, groupIds: {} };
   const orgsOf = {};
@@ -739,6 +741,8 @@ var ROW_SOURCE_KEYS = ["fieldcode", "state", "formulaSet", "edit", "hide", "rank
 
 // src/normalize/policy.ts
 import path4 from "node:path";
+var PolicyError = class extends Error {
+};
 var POLICY_FILE = path4.join("policy", "authoring-policy.json");
 var MAX_POLICY_BYTES = 64 * 1024;
 var DEFAULT_POLICY = { allowFunctions: [], allowMiscChanges: false };
@@ -1262,6 +1266,22 @@ function calcSettings(input) {
 }
 
 // src/worker/eval-run.ts
+function classifyEvalError(e) {
+  const message = String(e?.message ?? e);
+  if (e instanceof InputError) return { kind: "input", name: "InputError", message };
+  if (e instanceof PluginZipError) return { kind: "zip", name: "PluginZipError", message, code: e.code };
+  if (e instanceof UsersDataError) return { kind: "users", name: "UsersDataError", message };
+  if (e instanceof PolicyError) return { kind: "policy", name: "PolicyError", message };
+  return { kind: "other", name: builtinErrorName(e), message };
+}
+function builtinErrorName(e) {
+  if (e instanceof TypeError) return "TypeError";
+  if (e instanceof RangeError) return "RangeError";
+  if (e instanceof ReferenceError) return "ReferenceError";
+  if (e instanceof SyntaxError) return "SyntaxError";
+  if (e instanceof URIError) return "URIError";
+  return "Error";
+}
 async function runEvalJob(job) {
   const engine = await loadEngine({ pluginZip: job.pluginZip, devPluginDir: job.devPluginDir, mode: job.mode, vendorDir: job.vendorDir });
   if (job.baseUrl) engine.setContext({ baseUrl: job.baseUrl });
@@ -1316,9 +1336,4 @@ async function runEvalJob(job) {
 var post = (m) => {
   parentPort?.postMessage(m);
 };
-runEvalJob(workerData).then((outcome) => post({ ok: true, outcome })).catch((e) => {
-  const err = e;
-  const own = err?.name && err.name !== "Error" ? err.name : void 0;
-  const name = own ?? err?.constructor?.name ?? "Error";
-  post({ ok: false, error: { name: String(name), message: String(err?.message ?? e), ...err?.code ? { code: String(err.code) } : {} } });
-});
+runEvalJob(workerData).then((outcome) => post({ ok: true, outcome })).catch((e) => post({ ok: false, error: classifyEvalError(e) }));

package/dist/types/commands/save.d.ts

@@ -25,6 +25,8 @@ export interface SaveResult {
     message?: string;
     /** status が ok でないときの誤りの種類（ConflictError、PermissionError、PathError、InputError、NormalizeError、接続の誤りの code など。想定外の失敗は Error） */
     code?: string;
+    /** code が PluginZipError のときの、zip の誤りの種類（MCP が種類ごとの決まった文にする） */
+    zipCode?: string;
     /** ok だが、確定の後に一時ファイルかロックを消せなかった（確定はしている。利用者に伝えて消してもらう） */
     cleanup?: string[];
 }
@@ -58,6 +60,8 @@ export interface SaveContext {
 export declare const MAX_SAVE_INPUT_BYTES: number;
 /** updateFields の rows の行数の上限 */
 export declare const MAX_UPDATE_ROWS = 50;
+/** updateFields の common で置き換えられる共通の設定のキー（封筒と pluginInfos 以外の最上位のキー。設定ファイル仕様の順。Codex のレビュー MAJOR 4） */
+export declare const COMMON_KEYS: readonly string[];
 /** ファイルの digest（sha256。fml_summary が返し、fml_update_fields が照合する） */
 export declare function digestOf(text: string | Buffer): string;
 /** 接続の誤りの状態（print-craft MCP の 15.10 の表） */

package/dist/types/core.d.ts

@@ -27,13 +27,13 @@ export { DEFAULT_MAX_CALLS, USER_INFO_FUNCTIONS, UsersPullError, pullReferencedU
 export { normalizeSettings, findCycles, stronglyConnected, type ContextNeeds, type NormalizeInput, type NormalizeResult } from "./commands/normalize.ts";
 export { DEFAULT_EVENT, EVENT_RE, RECORDS_MAX, calcSettings, validateEvent, type CalcInput, type CalcLine, type CalcRecordResult, type CalcResult } from "./commands/calc.ts";
 export { takeInbox, type TakeResult } from "./commands/take.ts";
-export { MAX_SAVE_INPUT_BYTES, MAX_UPDATE_ROWS, connectionStatusOf, digestOf, saveNewSettings, updateFields, type EvalSource, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
+export { COMMON_KEYS, MAX_SAVE_INPUT_BYTES, MAX_UPDATE_ROWS, connectionStatusOf, digestOf, saveNewSettings, updateFields, type EvalSource, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
 export { DEFAULT_POLICY, POLICY_FILE, PolicyError, loadPolicy, parsePolicy, type Policy } from "./normalize/policy.ts";
 export { Findings, type Finding, type Level } from "./normalize/findings.ts";
 export { ENVELOPE_KEYS, OUTER_KEYS, ROW_SCREEN_KEYS, ROW_SOURCE_KEYS, materialsOf, viewsOf, type FormulaSaved, type FormulaSource, type Lang } from "./normalize/model.ts";
 export { DEFAULT_TIMEOUT_SEC, EvalError, EvalTimeoutError, MAX_TIMEOUT_SEC, runEval, type RunOptions } from "./worker/run.ts";
-export { runEvalJob } from "./worker/eval-run.ts";
-export type { EvalJob, EvalMessage, EvalOutcome } from "./worker/eval-job.ts";
+export { builtinErrorName, classifyEvalError, runEvalJob } from "./worker/eval-run.ts";
+export type { EvalErrorKind, EvalJob, EvalMessage, EvalOutcome } from "./worker/eval-job.ts";
 export { APP_MARKER, EDIT_RE, INBOX, KINTONE_ROOT, LEGACY_WORKSPACE_FILE, SNAPSHOT_PREFIX, SNAPSHOT_RE, WorkspaceError, appDirFor, appFolderOfFile, appFoldersOf, assertAppMark, assertInsideWorkspace, assertUsableInKintone, editNameOf, ensureAppFolder, findAppDir, folderNameOf, hasLegacyConfig, legacyBlockedError, listAppFolder, markOf, modeOf, profileDirOf, readAppMark, requireProfiles, snapshotNameOf, unusedProfileDirs, type AppFolderList, type AppMark, type AppMarkState, type ModeOptions, type ProfilesContext, type WorkspaceMode } from "./workspace.ts";
 export { CONNECTION_MAX_BYTES, ConnectionError, FALLBACK_PROFILE, PROFILE_NAME_RE, assertSameConnection, authFor, identityOf, loadConnections, pickProfile, sameIdentity, semanticDigest, snapshotOf, userApiAuthFor, type ConnectionErrorCode, type ConnectionSet, type ConnectionSnapshot, type Env, type LoadConnectionsOptions, type ProfileDef, type ProfileIdentity } from "./connections.ts";
 export { PermissionError, assertChangeAllowed, classOfAppPath, type ChangeOp, type TargetClass } from "./permission.ts";

package/dist/types/worker/eval-job.d.ts

@@ -71,12 +71,18 @@ export interface EvalOutcome {
     /** エンジンの読み込みの注意 */
     engineWarnings: string[];
 }
+/**
+ * Worker の中の誤りの種類（信頼できる境界 = 中核の eval-run.ts が instanceof で決める。zip のコードが name を偽装しても変わらない。Codex の r2 レビュー R1）:
+ * input（中核の InputError）、zip（PluginZipError。code 付き）、users（UsersDataError）、policy（PolicyError）、other（zip のコードの例外など。文は信用しない）
+ */
+export type EvalErrorKind = "input" | "zip" | "users" | "policy" | "other";
 export type EvalMessage = {
     ok: true;
     outcome: EvalOutcome;
 } | {
     ok: false;
     error: {
+        kind: EvalErrorKind;
         name: string;
         message: string;
         code?: string;

package/dist/types/worker/eval-run.d.ts

@@ -1,2 +1,12 @@
-import type { EvalJob, EvalOutcome } from "./eval-job.ts";
+import type { EvalJob, EvalMessage, EvalOutcome } from "./eval-job.ts";
+/**
+ * Worker の中の誤りを種類に分ける（instanceof で。中核のクラスは zip のコードから届かないので、name の偽装では input / zip にならない）。
+ * name も instanceof で決めた固定の名前（中核のクラスの名前か、JavaScript の組み込みの Error の名前。例外の name / constructor.name は使わない =
+ * zip のコードが name に値やパスを入れても出ない。Codex の r3 レビュー N1）。文は other のときは信用しない（呼ぶ側が決まった文にする）
+ */
+export declare function classifyEvalError(e: unknown): Extract<EvalMessage, {
+    ok: false;
+}>["error"];
+/** JavaScript の組み込みの Error の種類（instanceof。同じ realm で動く zip のコードの例外も、この判定は偽装できない）。それ以外は Error */
+export declare function builtinErrorName(e: unknown): string;
 export declare function runEvalJob(job: EvalJob): Promise<EvalOutcome>;

package/dist/types/worker/run.d.ts

@@ -1,13 +1,17 @@
-import type { EvalJob, EvalOutcome } from "./eval-job.ts";
+import type { EvalErrorKind, EvalJob, EvalOutcome } from "./eval-job.ts";
 export declare const DEFAULT_TIMEOUT_SEC = 60;
 export declare const MAX_TIMEOUT_SEC = 600;
 export declare class EvalTimeoutError extends Error {
 }
-/** Worker の中の誤り（name / code を持って主スレッドに戻す） */
+/**
+ * Worker の中の誤り（kind / name / code を持って主スレッドに戻す）。kind は中核が instanceof で決めた信頼できる種類（input / zip / users / policy / other）。
+ * innerName は参考の名前（other のときは zip のコードが付けた名前かもしれない）。other のときの文は値やパスを含みうる（MCP は返さない）
+ */
 export declare class EvalError extends Error {
     readonly innerName: string;
     readonly code?: string;
-    constructor(message: string, innerName: string, code?: string);
+    readonly kind: EvalErrorKind;
+    constructor(message: string, innerName: string, code?: string, kind?: EvalErrorKind);
 }
 export interface RunOptions {
     timeoutSec?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/formula-authoring-tools",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "rex0220 計算式プラグイン（kintone）の設定を AI で作るための CLI。利用者のプラグインの zip から authoring API と計算式エンジンを読んで Node で動く",
   "license": "MIT",
   "type": "module",