@rex0220/formula-authoring-tools 0.1.0 → 0.2.0

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.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"1e50847","builtAt":"2026-10-18T02:11:59.644Z","mode":"build"}');
   return devMeta();
 }
 
@@ -362,6 +362,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 +464,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 +549,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);
@@ -1259,7 +1263,7 @@ function calcSettings(input) {
 
 // src/worker/eval-run.ts
 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 +1280,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 +1307,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;
 }

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

@@ -0,0 +1,82 @@
+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;
+    /** 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;
+/** ファイルの 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 { 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 { 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,13 +47,26 @@ 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[];

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

@@ -13,5 +13,9 @@ 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>;

package/dist/types/workspace.d.ts

@@ -0,0 +1,126 @@
+import { ConnectionError, type ConnectionSet, type Env, type ProfileDef } from "./connections.ts";
+export declare const KINTONE_ROOT = "kintone";
+export declare const INBOX = "inbox";
+/** 1.x の作業フォルダーの環境の定義（2.0.0 から読まない。あれば移行を求めて止まる） */
+export declare const LEGACY_WORKSPACE_FILE = "environments.json";
+/** アプリのフォルダーの印（15.5） */
+export declare const APP_MARKER = ".formula-app.json";
+/** 設定画面のダウンロードのファイル名の接頭辞（kit の exportFileName。計算式プラグインの src/config/main.ts の exportPrefix） */
+export declare const SNAPSHOT_PREFIX = "rex0220-formula";
+export declare const SNAPSHOT_RE: RegExp;
+export declare const EDIT_RE: RegExp;
+export declare class WorkspaceError extends Error {
+}
+/**
+ * 動く形（15.4、15.11。r3 MAJOR 7）: single（1 接続の形。CLI だけ）、profiles（接続のファイルがある）、not-configured（MCP で接続のファイルが無い）、
+ * legacy-blocked（接続のファイルが無く environments.json がある）。どの形でも settings/ などのローカルの操作は動く。kintone/** を読む・書くのは profiles だけ
+ */
+export type WorkspaceMode = {
+    kind: "single";
+} | {
+    kind: "profiles";
+    connections: ProfilesContext;
+} | {
+    kind: "not-configured";
+} | {
+    kind: "legacy-blocked";
+};
+/** profile の形の文脈: 呼び出しの初めに読んだ接続（秘密を含む。外に出さない）と、確定の前に読み直す関数 */
+export interface ProfilesContext {
+    set: ConnectionSet;
+    reload: () => ConnectionSet;
+}
+export interface ModeOptions {
+    /** 接続のファイルの絶対パス（設定されていなければ undefined、設定されていて空なら ""） */
+    configFile: string | undefined;
+    /** そのプロセスが知っている作業フォルダー（この中の接続のファイルは使わない） */
+    workspaceRoots: readonly string[];
+    /** env: と passwordEnv を引く環境変数 */
+    env: Env;
+    /** 接続のファイルが無いときの形: CLI は single（.env の 1 接続）、MCP は not-configured */
+    surface: "cli" | "mcp";
+}
+/** 1.x の environments.json があるか（リンク切れの symlink も「ある」） */
+export declare function hasLegacyConfig(cwd: string): boolean;
+/** 移行で止まっているときの誤り（kintone を使う操作と kintone/** の操作が投げる） */
+export declare function legacyBlockedError(): ConnectionError;
+/**
+ * 動く形を決める（15.4 の表）。接続のファイルが設定されていれば読む（空・読めない・形が違うのは誤り。1 接続の形に戻らない）。
+ * 設定されていなければ、environments.json があれば legacy-blocked、無ければ CLI は single、MCP は not-configured
+ */
+export declare function modeOf(cwd: string, opt: ModeOptions): WorkspaceMode;
+/** kintone を使う操作・アプリのフォルダーの操作の前に: profile の形でなければ止める（未設定・移行で止まっている・1 接続の形の理由で） */
+export declare function requireProfiles(mode: WorkspaceMode, what: string): ProfilesContext;
+/** アプリのフォルダーの名前（番号-アプリ名。名前が使えなければ番号だけ） */
+export declare function folderNameOf(appId: number, appName: string): string;
+export declare function profileDirOf(cwd: string, profile: string): string;
+/**
+ * フォルダー・ファイルの実体（symlink を解いたもの）が作業フォルダーの中か。外なら一覧を作らず・読まずに PathError。リンク切れ・ループも PathError
+ * （kintone/<profile> や inbox が外への symlink のとき、外のファイルの名前を出さない。B1 の Codex レビュー BLOCKER 1）
+ */
+export declare function assertInsideWorkspace(cwd: string, p: string): void;
+/** 今あるアプリのフォルダー（番号で探す。無ければ null。同じ番号が 2 つあれば止まる）。kintone/ と profile のフォルダーの実体が作業フォルダーの中のときだけ一覧する */
+export declare function findAppDir(cwd: string, profile: string, appId: number): string | null;
+/** アプリのフォルダー（あればそれ、無ければ 番号-アプリ名 で作る場所。作るのは ensureAppFolder） */
+export declare function appDirFor(cwd: string, profile: string, appId: number, appName: string): string;
+/** ファイルが kintone/<profile>/<番号>-…/ の中（records/ などの下を含む）なら、そのフォルダーと profile と番号 */
+export declare function appFolderOfFile(cwd: string, file: string): {
+    dir: string;
+    profile: string;
+    appId: number;
+} | null;
+/** ダウンロードと同じ名前（kit の exportFileName と同じ。日時はこの PC の時刻） */
+export declare function snapshotNameOf(appId: number, now?: Date): string;
+export declare function editNameOf(snapshotFile: string): string;
+export interface AppMark {
+    schemaVersion: 1;
+    profile: string;
+    origin: string;
+    guestSpaceId: number | null;
+    appId: number;
+}
+export declare function markOf(def: ProfileDef, appId: number): AppMark;
+export type AppMarkState = {
+    state: "missing";
+} | {
+    state: "invalid";
+} | {
+    state: "ok";
+    mark: AppMark;
+};
+/** 印を読む（無い・壊れている・読めた） */
+export declare function readAppMark(dir: string): AppMarkState;
+/** アプリのフォルダーの印が、今の接続のこのアプリのものか（無い・壊れている・違うは ConnectionError。conflict） */
+export declare function assertAppMark(dir: string, def: ProfileDef, appId: number): void;
+/**
+ * アプリのフォルダーを使う（fields / pull / take だけが呼ぶ。15.5）。あれば印を確かめる。無ければ、同じ親の一時フォルダー（. で始まる名前）に印を置いてから
+ * 最後の名前に付け替える（途中で止まっても印の無いフォルダーを残さない。r3 MINOR 1）。付け替えの先が既にあれば（同時に作った）、その印を確かめて使う。
+ * dir は appDirFor の値（書ける場所と許可は呼ぶ側が先に確かめる）
+ */
+export declare function ensureAppFolder(dir: string, def: ProfileDef, appId: number): void;
+/**
+ * kintone/** の中のファイル・フォルダーを通常の操作で読む・一覧する前に（15.5、r3 MAJOR 3）: profile の形で、フォルダーの profile が接続のファイルにあり、
+ * 印が今の接続のこのアプリのものか。kintone/ の外なら何もしない。profile が無い = denied（PermissionError）、印 = conflict（ConnectionError）
+ */
+export declare function assertUsableInKintone(cwd: string, file: string, mode: WorkspaceMode): void;
+export interface AppFolderList {
+    dir: string;
+    hasFields: boolean;
+    /** ダウンロードと pull（新しい順） */
+    snapshots: string[];
+    /** 直したもの（新しい順） */
+    edits: string[];
+    /** AI が作った設定など、その他の json（. で始まる印などは出さない） */
+    others: string[];
+    records: string[];
+}
+/** アプリのフォルダーの一覧。cwd を渡すと、フォルダーと records の実体が作業フォルダーの中か確かめてから一覧する */
+export declare function listAppFolder(dir: string, cwd?: string): AppFolderList;
+/** profile のフォルダーの中のアプリのフォルダーと印の状態（診断と files の一覧。中身は返さない。15.5） */
+export declare function appFoldersOf(cwd: string, def: ProfileDef): Array<{
+    name: string;
+    appId: number | null;
+    mark: "ok" | "missing" | "invalid" | "conflict";
+}>;
+/** kintone/ の下の profile のフォルダーのうち、接続のファイルに無いもの（使われていないフォルダー。診断で名前だけ示す） */
+export declare function unusedProfileDirs(cwd: string, set: ConnectionSet): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/formula-authoring-tools",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "rex0220 計算式プラグイン（kintone）の設定を AI で作るための CLI。利用者のプラグインの zip から authoring API と計算式エンジンを読んで Node で動く",
   "license": "MIT",
   "type": "module",
@@ -34,6 +34,7 @@
     "prepack": "node scripts/vendor.mjs && node scripts/build.mjs",
     "gen-docs": "node scripts/gen-docs.mjs"
   },
+  "publishConfig": { "access": "public" },
   "homepage": "https://github.com/rex0220/formula-authoring#readme",
   "repository": {
     "type": "git",