@rex0220/formula-authoring-tools 0.1.0 → 0.2.1

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.1.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"69de71e","builtAt":"2026-10-18T00:25:51.113Z","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 = {};
@@ -362,6 +364,9 @@ function defaultUsersInfo() {
 }
 
 // src/engine.ts
+function momentFileOf(opt) {
+  return opt.vendorDir ? path3.join(opt.vendorDir, path3.basename(MOMENT_FILE)) : MOMENT_FILE;
+}
 var DEFAULT_CONTEXT_BASE_URL = "https://example.cybozu.com";
 var SENTINEL_USER = { id: "0", code: "__sentinel__", name: "", email: "", timezone: "Asia/Tokyo", language: "ja", isGuest: false };
 var loaded = null;
@@ -461,15 +466,16 @@ async function loadOnce(opt) {
   }
   if (!src.api) throw new PluginZipError(`計算式プラグインの zip に ${API_ENTRY} が無い（Ver.${MIN_PLUGIN_VERSION} 以降の zip が要る）: ${src.from}`, "no-api", known);
   if (!src.decimal) warnings.push(`zip に ${DECIMAL_ENTRY} が無い（べき乗の小数の指数がエラーになる）`);
-  if (!existsSync(MOMENT_FILE)) throw new Error(`moment が無い: ${MOMENT_FILE}（tools の npm install 時に取る。手で取るなら npm run vendor）`);
+  const momentFile = momentFileOf(opt);
+  if (!existsSync(momentFile)) throw new Error(`moment が無い: ${momentFile}（tools の npm install 時に取る。手で取るなら npm run vendor）`);
   try {
-    return await startEngine({ ...src, api: src.api }, known, warnings, stamp);
+    return await startEngine({ ...src, api: src.api }, known, warnings, stamp, momentFile);
   } catch (e) {
     poisoned = { code: e instanceof PluginZipError ? e.code : "unexpected", info: e instanceof PluginZipError ? e.info : known };
     throw e;
   }
 }
-async function startEngine(src, known, warnings, stamp) {
+async function startEngine(src, known, warnings, stamp, momentFile) {
   const g = globalThis;
   const { Window } = await import("happy-dom");
   const ctx = {
@@ -545,7 +551,7 @@ async function startEngine(src, known, warnings, stamp) {
       throw new PluginZipError(`計算式プラグインの zip のコード（${entry}）を実行できない: ${e instanceof Error ? e.message : String(e)}`, "engine-unreadable", known);
     }
   };
-  runScript(readFileSync3(MOMENT_FILE, "utf8"), MOMENT_FILE);
+  runScript(readFileSync3(momentFile, "utf8"), momentFile);
   runScript(src.momentTimezone, `${src.from}!${MOMENT_TZ_ENTRY}`, MOMENT_TZ_ENTRY);
   runScript(src.bignumber, `${src.from}!${BIGNUMBER_ENTRY}`, BIGNUMBER_ENTRY);
   if (src.decimal) runScript(src.decimal, `${src.from}!${DECIMAL_ENTRY}`, DECIMAL_ENTRY);
@@ -735,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 };
@@ -1258,8 +1266,24 @@ 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 });
+  const engine = await loadEngine({ pluginZip: job.pluginZip, devPluginDir: job.devPluginDir, mode: job.mode, vendorDir: job.vendorDir });
   if (job.baseUrl) engine.setContext({ baseUrl: job.baseUrl });
   const usersInfo = buildUsersInfo(job.usersSource);
   const usersLabel = job.usersOrigin.kind === "file" ? job.usersOrigin.file : "既定のテストデータ（架空）";
@@ -1276,7 +1300,16 @@ async function runEvalJob(job) {
     usersOrigin: job.usersOrigin
   });
   const outcome = {
-    normalize: { summary: res.summary, hasErrors: res.findings.hasErrors, warnings: res.findings.count("warning"), output: res.output, checkDiffs: res.checkDiffs },
+    normalize: {
+      summary: res.summary,
+      hasErrors: res.findings.hasErrors,
+      warnings: res.findings.count("warning"),
+      findings: [...res.findings.items],
+      output: res.output,
+      checkDiffs: res.checkDiffs,
+      appId: res.appId,
+      size: res.size
+    },
     engineWarnings: [...engine.warnings]
   };
   if (job.kind === "calc" && job.calc && !res.findings.hasErrors) {
@@ -1294,7 +1327,7 @@ async function runEvalJob(job) {
       usersInfo,
       usersOrigin: job.usersOrigin
     });
-    outcome.calc = { text: r.text, failed: r.records.some((x) => x.errors.length > 0 || x.failed) };
+    outcome.calc = { text: r.text, failed: r.records.some((x) => x.errors.length > 0 || x.failed), records: r.records, contextLine: r.contextLine, notice: r.notice, summary: r.summary };
   }
   return outcome;
 }
@@ -1303,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

@@ -0,0 +1,86 @@
+import { type Lang } from "../normalize/model.ts";
+import type { Policy } from "../normalize/policy.ts";
+import type { Finding } from "../normalize/findings.ts";
+import { type WorkspaceMode } from "../workspace.ts";
+import { ConnectionError } from "../connections.ts";
+import { type UsersOrigin, type UsersSource } from "../users/index.ts";
+import { type FieldChange } from "./diff.ts";
+import { type RunOptions } from "../worker/run.ts";
+export type SaveStatus = "ok" | "invalid" | "conflict" | "denied" | "failed";
+export interface SaveResult {
+    status: SaveStatus;
+    /** 作業フォルダーからの相対パス（区切りは /） */
+    path: string;
+    /** 確定したファイルの digest（sha256。ok のとき） */
+    digest?: string;
+    findings: Finding[];
+    /** normalize の要約（検査まで進んだとき） */
+    summary?: string;
+    /** updateFields: 前の内容と確定した内容の差（項目ごと。affectsRecords = 既存レコードの値に影響する） */
+    diff?: {
+        fields: FieldChange[];
+        common: string[];
+    };
+    /** status が ok でないときの理由（決まった文） */
+    message?: string;
+    /** status が ok でないときの誤りの種類（ConflictError、PermissionError、PathError、InputError、NormalizeError、接続の誤りの code など。想定外の失敗は Error） */
+    code?: string;
+    /** code が PluginZipError のときの、zip の誤りの種類（MCP が種類ごとの決まった文にする） */
+    zipCode?: string;
+    /** ok だが、確定の後に一時ファイルかロックを消せなかった（確定はしている。利用者に伝えて消してもらう） */
+    cleanup?: string[];
+}
+/** 評価（normalize）の読み込み元（Worker に渡す。中核は環境変数を読まない） */
+export interface EvalSource {
+    pluginZip?: string;
+    devPluginDir?: string;
+    mode?: "build" | "dev";
+    /** moment の置き場所（MCP は束ねた本体の隣の vendor/） */
+    vendorDir?: string;
+}
+export interface SaveContext {
+    /** 作業フォルダーの実際のパス */
+    root: string;
+    /** 動く形（kintone/ の下を読む・変えてよいか。workspace.ts の modeOf） */
+    mode: WorkspaceMode;
+    policy: Policy;
+    source: EvalSource;
+    /** Worker の動かし方（時間上限、入口、出力の受け取り先） */
+    run?: RunOptions;
+    /** 評価の文脈の接続先（検証済み。APP_URL などの元） */
+    baseUrl?: string;
+    /** ユーザー情報のテストデータ（無ければ既定の架空の 10 人） */
+    usersSource?: UsersSource;
+    usersOrigin?: UsersOrigin;
+    lang?: Lang;
+    /** 試験用: 確定の直後（片付けの前）に呼ぶ。MCP は渡さない */
+    afterPlace?: () => void;
+}
+/** 入力（content / rows / common）の上限（バイト） */
+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 の表） */
+export declare function connectionStatusOf(e: ConnectionError): Exclude<SaveStatus, "ok">;
+/** 新しい設定を保存する（expectedAbsent: true が要る。同じ名前のファイルがあれば conflict） */
+export declare function saveNewSettings(ctx: SaveContext, opt: {
+    path: string;
+    content: string;
+    fields?: string;
+    expectedAbsent: true;
+}): Promise<SaveResult>;
+/**
+ * 既存の設定の項目の行を差し替える（rows は fieldcode の行の JSON の配列の文字列。common は共通の設定の JSON の文字列）。
+ * expectedDigest は fml_summary（summary）が返した値。差し替えた後の設定を normalize し、エラーが無ければ確定する
+ */
+export declare function updateFields(ctx: SaveContext, opt: {
+    path: string;
+    expectedDigest: string;
+    rows: string;
+    common?: string;
+    fields?: string;
+}): Promise<SaveResult>;

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

@@ -0,0 +1,18 @@
+import { type WorkspaceMode } from "../workspace.ts";
+export interface TakeResult {
+    /** leftInInbox: 行き先には置いたが inbox の元を消せなかった（消してよい。次の take でも「同じもの」として消す） */
+    moved: Array<{
+        file: string;
+        to: string;
+        same: boolean;
+        leftInInbox?: boolean;
+    }>;
+    /** reason は決まった文（ファイルの中身・絶対パス・秘密の値を入れない。Codex の実装レビュー BLOCKER 1） */
+    skipped: Array<{
+        file: string;
+        reason: string;
+    }>;
+    /** 置いたが一時ファイルを消せなかった、など（移したことは変わらない） */
+    warnings: string[];
+}
+export declare function takeInbox(cwdIn: string, mode: WorkspaceMode, profile?: string): TakeResult;

package/dist/types/commit-file.d.ts

@@ -0,0 +1,38 @@
+export declare const LOCK_STALE_MS = 60000;
+/** 確定先に同じ名前のファイルが既にある（確かめた後に作られた場合を含む） */
+export declare class FileExistsError extends Error {
+}
+/** 同じファイルへの別の書き込みがロックを持っている */
+export declare class LockBusyError extends Error {
+}
+/** EPERM / EBUSY なら短く待ってやり直す（tries 回まで）。それ以外の失敗はそのまま投げる */
+export declare function withRetry<T>(fn: () => T, tries?: number): T;
+/** 片付けを 1 つずつ試し、失敗の文を返す（一方の失敗で他方を飛ばさない。EPERM / EBUSY は短く待ってやり直す） */
+export declare function cleanupAll(steps: Array<() => void>, tries?: number): string[];
+/** 確定先と同じフォルダーの一時ファイルの名前 */
+export declare function tempPathFor(target: string): string;
+/** 一時ファイルを新しい名前で確定する（同じ名前があれば FileExistsError。上書きしない）。link は試験用（ハードリンクが使えない場合を作る） */
+export declare function placeNew(tmp: string, target: string, link?: (from: string, to: string) => void): void;
+export interface WriteNewResult {
+    /** 確定の後の片付けの失敗（確定はしている） */
+    cleanup: string[];
+}
+/**
+ * 新しいファイルとして書く。recheck は一時ファイルを書く前と確定の直前に呼ぶ（書ける場所・許可を確かめ直す。投げれば確定しない）。
+ * 同じ名前があれば FileExistsError（確かめた後に作られた場合も）。失敗したら一時ファイルを消す
+ */
+export declare function writeNewFile(target: string, text: string, recheck?: () => void): WriteNewResult;
+export interface Lock {
+    /** まだ自分のロックか（確定の直前に確かめる） */
+    owned(): boolean;
+    /** 自分のロックなら外す（他の保存が取り直したロックは消さない）。外したら true */
+    release(): boolean;
+}
+export declare function lockPathFor(target: string): string;
+/** 試験用: 古いロックを付け替える直前・戻す直前に呼ぶ（その間に替わる場合を作る） */
+export interface LockTestHooks {
+    beforeClaim?: () => void;
+    beforeRestore?: () => void;
+}
+/** 確定先のロックを取る。取れなければ LockBusyError */
+export declare function acquireLock(target: string, staleMs?: number, hooks?: LockTestHooks): Lock;

package/dist/types/connections.d.ts

@@ -0,0 +1,106 @@
+import { type Stats } from "node:fs";
+import type { KintoneAuth } from "./env.ts";
+export declare const CONNECTION_MAX_BYTES: number;
+/** 接続のファイルを読むときの fs の呼び出し（試験だけが差し替える。読み込みの途中の書き換えを再現するため。中核の入口 core.ts からは出さない） */
+interface FsOps {
+    openSync: (p: string, flags: string) => number;
+    fstatSync: (fd: number) => Stats;
+    readSync: (fd: number, buf: Buffer, offset: number, length: number, position: number) => number;
+    closeSync: (fd: number) => void;
+    statSync: (p: string) => Stats;
+}
+/** 試験用: fs の呼び出しを差し替える（undefined で元に戻す） */
+export declare function setFsOpsForTest(ops?: Partial<FsOps>): void;
+/** profile の名前（kintone/<profile>/ のフォルダーの名前になる） */
+export declare const PROFILE_NAME_RE: RegExp;
+/** kSQL と同じ: 引数も defaultProfile も無ければ dev（15.1 の 8） */
+export declare const FALLBACK_PROFILE = "dev";
+/** 誤りの種類（15.10。status は呼ぶ側が決める: inside-workspace は denied、unknown-profile と guest-mismatch は invalid、印と connection-changed は conflict、ほかは failed） */
+export type ConnectionErrorCode = "not-configured" | "unreadable" | "inside-workspace" | "legacy-config-present" | "unknown-profile" | "no-default-profile" | "profile-invalid" | "no-token" | "env-missing" | "no-userpass" | "no-user-api-auth" | "guest-mismatch" | "app-marker-missing" | "app-marker-invalid" | "app-identity-conflict" | "connection-changed";
+export declare class ConnectionError extends Error {
+    readonly code: ConnectionErrorCode;
+    constructor(message: string, code: ConnectionErrorCode);
+}
+export type Env = Readonly<Record<string, string | undefined>>;
+/** profile の秘密でない識別（アプリのフォルダーの印と、確定の前の比較に使う） */
+export interface ProfileIdentity {
+    profile: string;
+    baseUrl: string;
+    host: string;
+    /** ゲストスペースの番号（通常のスペースは null） */
+    guestSpaceId: number | null;
+}
+export interface ProfileDef extends ProfileIdentity {
+    /** auto を解決した後の認証の種類 */
+    auth: "token" | "userpass";
+    /** tokenMap のアプリの番号（値は持たない） */
+    tokenApps: number[];
+    /** アプリごとに、トークンが使えるか（env: の変数があるか。変数の名前は持たない） */
+    tokenReady: Record<number, boolean>;
+    /** ログイン名とパスワードがそろっているか（userpass のとき） */
+    userpassReady: boolean;
+    /** User API の cybozu.com 共通の API トークンがあるか（userApiToken。env: なら変数があるか。値は持たない） */
+    userApiTokenReady: boolean;
+}
+export interface ConnectionSet {
+    /** 接続のファイルの名前（パスは持たない。応答に出してよいのはこれだけ） */
+    fileName: string;
+    /** 中身の sha256 */
+    digest: string;
+    /** ファイルに書いた defaultProfile（無ければ undefined） */
+    defaultProfile?: string;
+    /** 使える profile */
+    profiles: ReadonlyMap<string, ProfileDef>;
+    /** 使えない profile と理由（決まった文。値を含まない） */
+    invalid: ReadonlyArray<{
+        name: string;
+        reason: string;
+    }>;
+    /** 警告（ほかの利用者が読める、など。パスを含まない） */
+    warnings: readonly string[];
+}
+/**
+ * 接続のスナップショット（15.6）: 呼び出しの初めに選んだ profile の秘密でない値。kintone の API・保存先・アプリのフォルダーの印・preview の接続先に同じものを使い、
+ * 確定の直前に読み直した profile の意味の digest（semanticDigest）と比べる。ファイル全体の digest は使わない（ほかの profile だけの書き換えでは止めない）
+ */
+export interface ConnectionSnapshot extends ProfileIdentity {
+    auth: "token" | "userpass";
+    /** 読んだ接続のファイルの名前（文に出してよいのはこれだけ） */
+    fileName: string;
+}
+export interface LoadConnectionsOptions {
+    /** そのプロセスが知っている作業フォルダー（この中の接続のファイルは使わない） */
+    workspaceRoots: readonly string[];
+    /** env: と passwordEnv を引く環境変数（中核は process.env を読まない） */
+    env: Env;
+}
+/**
+ * 接続のファイルを読む（15.2、15.3）。file は絶対パス（設定の値の ~ の展開と引用符を外すのは呼ぶ側）。
+ * 読めない・作業フォルダーの中は ConnectionError。profile ごとの誤りは invalid に入れる（ほかの profile は使える）
+ */
+export declare function loadConnections(file: string | undefined, opt: LoadConnectionsOptions): ConnectionSet;
+/** profile を選ぶ（15.2: 引数 → defaultProfile → "dev"） */
+export declare function pickProfile(set: ConnectionSet, name?: string): ProfileDef;
+/** 選んだ profile のスナップショット（15.6） */
+export declare function snapshotOf(set: ConnectionSet, def: ProfileDef): ConnectionSnapshot;
+/**
+ * 選んだ profile の意味の digest（15.6）: profile、接続先、ゲストスペース、認証の種類、対象のアプリと、資格情報の指紋（解決したログイン名とパスワード、
+ * または対象のアプリのトークンの HMAC。鍵はプロセスごとの乱数）。直接書いた値・ログイン名・env: の参照先の値の入れ替えも違う digest になる（r3 MAJOR 1）。
+ * この digest も指紋も外に出さない（このプロセスの中で比べるだけ）
+ */
+export declare function semanticDigest(set: ConnectionSet, def: ProfileDef, appId?: number): string;
+/** 確定の直前に、読み直した接続で同じ profile の意味の digest が同じか（違えば connection-changed） */
+export declare function assertSameConnection(before: {
+    set: ConnectionSet;
+    def: ProfileDef;
+}, reload: () => ConnectionSet, appId?: number): void;
+/** アプリ N の認証（15.2）。対象のアプリのトークンだけを解決する */
+export declare function authFor(set: ConnectionSet, profile: ProfileDef, appId: number): KintoneAuth;
+/**
+ * User API（users --pull）の認証（計算式の tools の拡張）: profile の userApiToken（cybozu.com 共通管理の API トークン。Bearer）があればそれ、
+ * 無ければログイン名とパスワード（2 要素認証のないアカウント）。アプリの API トークン（tokenMap）では User API を呼べないので使わない
+ */
+export declare function userApiAuthFor(set: ConnectionSet, profile: ProfileDef): KintoneAuth;
+export declare function identityOf(def: ProfileDef): ProfileIdentity;
+export declare function sameIdentity(a: ProfileIdentity, b: ProfileIdentity): boolean;
+export {};

package/dist/types/core.d.ts

@@ -1,17 +1,20 @@
 /**
- * 中核の入口（@rex0220/formula-authoring-tools/core。後の MCP が使う）。cli.ts と dev-paths.ts は含めない（環境変数と process.cwd を読むのは CLI だけ）。
- * 工程 0（2026-10-17）: 読み込み（engine）、ダミー層（context）、ユーザー情報のテストデータ、zip の読み込み、安全なパス、接続。コマンドは工程 1 以降で足す
+ * 中核の入口（@rex0220/formula-authoring-tools/core。formula MCP が使う）。cli.ts と dev-paths.ts は含めない（環境変数と process.cwd を読むのは CLI だけ）。
+ * 工程 0（2026-10-17）: 読み込み（engine）、ダミー層（context）、ユーザー情報のテストデータ、zip の読み込み、安全なパス、接続。
+ * tools 0.2.0（計画 24.4。CORE_API_VERSION 2）: 作業フォルダーとアプリのフォルダー（workspace）、接続のファイル（connections）、kintone/ の下の許可（permission）、
+ * ファイルの確定とロック（commit-file）、take、保存の約束（save: saveNewSettings / updateFields）、users の参照するコードの取得、JSON の誤りの文、行のキー
  */
-export declare const CORE_API_VERSION = 1;
+export declare const CORE_API_VERSION = 2;
 export { createContext, type WorkContext } from "./context.ts";
-export { PathError, WRITE_ROOTS, isInside, realResolve, resolveRead, resolveWrite } from "./safe-path.ts";
-export { FORMULA_PLUGIN_ID, MIN_PLUGIN_VERSION, SUPPORTED_API_VERSIONS, REQUIRED_API, isSupportedPluginVersion, schemaRevisionOf, toolsMeta, type ToolsMeta } from "./meta.ts";
-export { DEFAULT_CONTEXT_BASE_URL, SENTINEL_USER, loadEngine, resolvePluginSources, type CalcEvent, type Engine, type EngineContext, type EngineSource, type FormulaAuthoringApi, type FormulaInstance, type LoadEngineOptions, type LoginUser, type SinkCall } from "./engine.ts";
+export { PathError, WRITE_ROOTS, isInside, realResolve, resolveRead, resolveWrite, resolveWriteDir, safeFileName } from "./safe-path.ts";
+export { FORMULA_PLUGIN_ID, FORMULA_CONFIG_PLUGIN_ID, MIN_PLUGIN_VERSION, SUPPORTED_API_VERSIONS, REQUIRED_API, isSupportedPluginVersion, schemaRevisionOf, toolsMeta, type ToolsMeta } from "./meta.ts";
+export { DEFAULT_CONTEXT_BASE_URL, SENTINEL_USER, loadEngine, momentFileOf, resolvePluginSources, type CalcEvent, type Engine, type EngineContext, type EngineSource, type FormulaAuthoringApi, type FormulaInstance, type LoadEngineOptions, type LoginUser, type SinkCall } from "./engine.ts";
 export { PluginZipError, pluginIdOf, readPluginZip, type PluginSources, type PluginZipErrorCode, type PluginZipErrorInfo } from "./plugin-zip.ts";
 export { DEFAULT_USERS, UsersDataError, buildUsersInfo, defaultUsersInfo, summarizeUsers, validateUsersSource, type UsersInfoTable, type UsersOrigin, type UsersSource } from "./users/index.ts";
-export { AuthError, baseUrlFromEnv, describeAuth, kintoneConfigPath, loadAuth, pluginZipPath, unquote, type KintoneAuth, type LoadAuthOptions } from "./env.ts";
+export { AuthError, baseUrlFromEnv, describeAuth, kintoneConfigPath, loadAuth, loadUserApiAuth, pluginZipPath, unquote, type KintoneAuth, type LoadAuthOptions } from "./env.ts";
 export { KintoneUrlError, isKintoneBaseUrl, normalizeKintoneBaseUrl } from "./kintone-url.ts";
 export { InputError, MAX_INPUT_BYTES, PLUGIN_NAME, formatDate, jsonDiff, readFieldsFile, readJsonLimited, readTextLimited, relativeSettingsPath } from "./input.ts";
+export { jsonErrorText, jsonErrorWhere } from "./json-error.ts";
 export { ALLOWED_APIS, ALLOWED_USER_APIS, NotAllowedError, RECEIVE_LIMITS, RestError, createRestClient, type AllowedApi, type AllowedUserApi, type FetchLike, type RestClient } from "./kintone-rest.ts";
 export { scanFormula, scanFormulas, type ScanResult } from "./scan.ts";
 export { contextTargetsOf, fetchFields, listFields, referenceTablesOf, summarizeFields, type FieldProperty, type FieldsFile, type FieldsOptions, type LayoutRow } from "./commands/fields.ts";
@@ -20,13 +23,18 @@ export { LIST_LIMIT, QUERY_MAX, QueryError, SHAPE_TEXT_MAX, listQueryOf, listRec
 export { defaultPullName, pullSettings, type PullOptions, type PullResult } from "./commands/pull.ts";
 export { bodyOf, rowsOf, summarizeSettings, type Envelope, type SourceRow } from "./commands/summary.ts";
 export { diffSettings, type DiffResult, type FieldChange } from "./commands/diff.ts";
-export { DEFAULT_MAX_CALLS, UsersPullError, pullUsers, usersFileNameOf, type PullUsersOptions } from "./commands/users.ts";
-export { normalizeSettings, findCycles, type NormalizeInput, type NormalizeResult } from "./commands/normalize.ts";
+export { DEFAULT_MAX_CALLS, USER_INFO_FUNCTIONS, UsersPullError, pullReferencedUsers, pullUsers, referencedCodesOf, scanUserInfoCalls, usersFileNameOf, type PullUsersOptions, type ReferencedCodes } from "./commands/users.ts";
+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 { 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 { materialsOf, viewsOf, type FormulaSaved, type FormulaSource, type Lang } from "./normalize/model.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 { stronglyConnected, type ContextNeeds } from "./commands/normalize.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";
+export { FileExistsError, LOCK_STALE_MS, LockBusyError, acquireLock, cleanupAll, lockPathFor, placeNew, tempPathFor, withRetry, writeNewFile, type Lock, type WriteNewResult } from "./commit-file.ts";

package/dist/types/engine.d.ts

@@ -99,7 +99,11 @@ export interface LoadEngineOptions {
     /** 開発中（mode dev）の読み込み元（隣の formula の prod/）。CLI は FORMULA_ALLOW_DEV_PLUGIN=1 のときだけ dev-paths.ts の formulaProdDir で決めて渡す */
     devPluginDir?: string;
     mode?: "build" | "dev";
+    /** moment（vendor/）の置き場所。省略すれば tools の vendor/（paths.ts）。MCP は束ねた本体の隣の vendor/ を渡す（tools 0.2.0） */
+    vendorDir?: string;
 }
+/** moment のファイル（vendorDir があればその中。無ければ tools の vendor/） */
+export declare function momentFileOf(opt: LoadEngineOptions): string;
 export declare const DEFAULT_CONTEXT_BASE_URL = "https://example.cybozu.com";
 /** 指定が無いときにコンストラクターへ返す番兵（式が使えば走査で止める。calc の表には「ログインユーザー: 指定なし」） */
 export declare const SENTINEL_USER: LoginUser;

package/dist/types/permission-error.d.ts

@@ -0,0 +1,3 @@
+/** kintone/ の下を変える・読むのを断るときの誤り（決まった文。permission.ts と workspace.ts が使う。お互いを読み込まないように別のモジュールにした） */
+export declare class PermissionError extends Error {
+}

package/dist/types/permission.d.ts

@@ -0,0 +1,10 @@
+import { PermissionError } from "./permission-error.ts";
+import { type WorkspaceMode } from "./workspace.ts";
+export { PermissionError };
+export type ChangeOp = "settings" | "snapshot" | "fields" | "record";
+/** アプリのフォルダーの中の場所（print-craft の docs/permission-table.md の P4〜P9 から out/ を除いたもの） */
+export type TargetClass = "snapshot" | "edit" | "newsettings" | "fields" | "record" | "other";
+/** アプリのフォルダーからの相対パスで場所を分ける。. で始まる名前（印など）はどの操作でも書けない other */
+export declare function classOfAppPath(relInFolder: string): TargetClass;
+/** kintone/ の下をこの操作で変えてよいか。だめなら PermissionError（denied）か ConnectionError（印・接続の変化は conflict。移行で止まっているのは failed） */
+export declare function assertChangeAllowed(root: string, file: string, op: ChangeOp, mode: WorkspaceMode): void;

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

@@ -1,9 +1,12 @@
 /**
  * Worker に渡す仕事と返す結果（構造化クローンで渡せる形だけ。関数やクラスは渡さない）。
  * normalize / calc の評価（zip のコードの実行）は Worker の中で行い、主スレッドは時間上限で terminate する（計画 7 章・11 章、Codex レビュー BLOCKER 1）。
+ * tools 0.2.0（MCP。計画 24 章）: 結果に findings と calc のレコードごとの行を足した（MCP が構造のまま返す。CLI は summary / text を使う）。vendorDir（moment の置き場所）
  */
 import type { FieldsFile } from "../commands/fields.ts";
 import type { KintoneRecord } from "../commands/record.ts";
+import type { CalcRecordResult } from "../commands/calc.ts";
+import type { Finding } from "../normalize/findings.ts";
 import type { Policy } from "../normalize/policy.ts";
 import type { UsersOrigin, UsersSource } from "../users/index.ts";
 import type { CalcEvent } from "../engine.ts";
@@ -13,6 +16,8 @@ export interface EvalJob {
     pluginZip?: string;
     devPluginDir?: string;
     mode?: "build" | "dev";
+    /** moment（vendor/）の置き場所（省略すれば tools の vendor/。MCP は束ねた本体の隣） */
+    vendorDir?: string;
     /** 接続先（検証済み。APP_URL などの元。無ければ既定） */
     baseUrl?: string;
     settingsText: string;
@@ -42,23 +47,42 @@ export interface EvalOutcome {
         summary: string;
         hasErrors: boolean;
         warnings: number;
+        /** 検査の結果（エラー / 警告 / 情報。MCP が返す） */
+        findings: Finding[];
         output?: Record<string, unknown>;
         checkDiffs?: string[];
+        /** 封筒の appId と、保存値の大きさの見積もり */
+        appId?: number;
+        size?: {
+            bytes: number;
+            keys: number;
+        };
     };
     calc?: {
         text: string;
         /** エラーか sink のあるレコードがある */
         failed: boolean;
+        /** レコードごとの結果（項目ごとの前後の値。MCP が返す） */
+        records: CalcRecordResult[];
+        contextLine: string;
+        notice: string;
+        summary: string;
     };
     /** エンジンの読み込みの注意 */
     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,17 +1,25 @@
-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;
     /** 主スレッドで動かす（テスト） */
     inline?: boolean;
+    /** Worker の入口（絶対パス）。省略すれば自分の隣の eval-worker.mjs / eval-worker.ts */
+    workerFile?: string;
+    /** Worker の標準出力・標準エラーの受け取り先（渡すと親の標準出力・標準エラーに流さない） */
+    captureOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
 }
 export declare function runEval(job: EvalJob, opt?: RunOptions): Promise<EvalOutcome>;