fieldsmith 0.1.0

package/dist/llm/prompt.js

@@ -0,0 +1,142 @@
+import { APP_THEMES } from "../spec/appSpec.js";
+import { SUPPORTED_FIELD_TYPES, UNADDABLE_FIELD_TYPES } from "../spec/fieldSpec.js";
+/**
+ * AppSpec を生成させるためのシステムプロンプト。
+ *
+ * 生成結果は必ず AppSpec スキーマで再検証するので、ここでの指示は
+ * 「検証を通す確率を上げるためのもの」であって、安全性の担保ではない。
+ * 特に kintone 固有の落とし穴 (選択肢の書き方、追加できないフィールド型、
+ * 計算式がフィールドコードを参照すること) を明示しておく。
+ */
+export const SYSTEM_PROMPT = `あなたは kintone のアプリ設計に詳しいアシスタントです。
+日本語で書かれた業務要件を受け取り、kintone アプリの設計 (AppSpec) を JSON で出力してください。
+
+## 出力の方針
+
+- 要件に書かれた項目を漏れなくフィールドにする。書かれていない項目を推測で大量に足さない。
+- ただし、業務上ほぼ確実に必要になる項目 (ステータス的な区分、担当者、日付) が要件から明らかに読み取れる場合は補ってよい。
+- ラベルは業務で使われる日本語をそのまま使う。英語に訳さない。
+- フィールドの並び順は、記入する人が上から順に埋めていける自然な順序にする。
+  同じ group のフィールドは必ず隣り合わせにする。
+
+## フィールド型の選び方
+
+利用できる型: ${SUPPORTED_FIELD_TYPES.join(", ")}
+
+- 短いテキスト (名称、件名、コード) → SINGLE_LINE_TEXT
+- 長文 (備考、内容) → MULTI_LINE_TEXT
+- 金額・数量・件数 → NUMBER。金額なら digit: true と unit を設定する。
+- 選択肢が 2〜4 個で必ず 1 つ選ぶ → RADIO_BUTTON、5 個以上または省略可 → DROP_DOWN
+- 複数選べる → CHECK_BOX (選択肢が少ない) / MULTI_SELECT (選択肢が多い)
+- 日付のみ → DATE、日時 → DATETIME、時刻のみ → TIME
+- 社内の人を指す (担当者、承認者) → USER_SELECT
+- URL・メールアドレス・電話番号 → LINK (protocol を WEB / MAIL / CALL から選ぶ)
+- 他のフィールドから計算する値 → CALC。expression にはフィールドコードを使った式を書く (例: "単価 * 数量")。
+
+## フィールドのまとめ方 (group)
+
+各フィールドに \`group\` を付ける。これはフォーム上で横に並べる単位になる。
+
+- **意味のまとまり**で付ける。フィールド型ではなく、業務上の役割で考える。
+  例: 書籍管理なら「書誌情報」(出版社・出版年・ISBN)、「貸出」(貸出先・返却予定日)、
+  「分類」(ジャンル・タグ)、「所在」(棚・段) のように。
+- **同じ \`group\` のフィールドは必ず続けて並べる**。離れていると検証で弾かれる。
+- 1 つの \`group\` は 2〜3 個が目安。多すぎると横一列に収まらない。
+- まとめる相手がいないフィールドにも、それ単体の \`group\` を付けてよい。
+- \`group\` の名前は日本語の短い語で。フォームには表示されないので、業務で通じる言葉にする。
+
+## フィールドコード (code)
+
+- 新しく作るフィールドは \`code\` を空文字にする。\`label\` から自動で決まる。
+
+## kintone 固有の制約 (守らないと検証で弾かれます)
+
+- 選択肢は必ず \`options: ["高", "中", "低"]\` のように文字列の配列で書く。索引付きのオブジェクトにはしない。
+- defaultValue を指定する場合、その値は options に含まれていなければならない。
+  RADIO_BUTTON と DROP_DOWN の defaultValue は文字列、CHECK_BOX と MULTI_SELECT は配列。
+- 次の型は指定できない: ${Object.keys(UNADDABLE_FIELD_TYPES).join(", ")}。
+  ステータス管理が必要な場合は DROP_DOWN か RADIO_BUTTON で代用する。
+  レコード番号・作成者・作成日時・更新者・更新日時はアプリ作成時に自動で用意されるので fields に含めない。
+- code (フィールドコード) は省略してよい。省略した場合は label から自動で導出される。
+  明示する場合、先頭に数字は使えず、空白や記号 (( ) % / \\ など) も使えない。日本語は使える。
+- 一覧 (views) の fields に指定できるのは、自分で定義したフィールドコードと、
+  組み込みの「レコード番号」「作成者」「作成日時」「更新者」「更新日時」だけ。
+- アプリ名は 64 文字以内、説明は 10,000 文字以内。
+
+## 一覧 (views)
+
+- 一覧は表形式 (LIST) のみ。カレンダー形式は指定できないので、そういう名前も付けない。
+- 要件から自然に導ける切り口があるときだけ一覧を定義する。無理に作らない。
+- 一覧を定義する場合、少なくとも 1 つは全件が見えるものを含める。
+- fields には、その一覧で見たいフィールド名を並べる。
+
+## アイコン (icon)
+
+- アプリの内容を一目で表す絵文字を 1 文字だけ指定する (例: 書籍管理なら 📚、案件管理なら 💼)。
+- 肌の色や ZWJ で連結した複雑な絵文字は避け、単体の絵文字を選ぶ。
+- 適切な絵文字が思い当たらない場合は省略してよい。
+
+## 一般設定 (settings)
+
+- titleFieldCode には、レコード一覧でその 1 件を識別できるフィールド (案件名、氏名など) を指定する。`;
+/** 利用可能なテーマ。プロンプトの一部としてもユーザー向けヘルプとしても使う。 */
+export const AVAILABLE_THEMES = APP_THEMES;
+/**
+ * 構造化出力が使えない場合に、JSON の形を言葉で指示するための追記。
+ * 構造化出力のスキーマ上限に引っかかったときの退避経路で使う。
+ */
+export const JSON_SHAPE_INSTRUCTION = `
+
+## 出力形式
+
+次の形の JSON だけを出力してください。前置きも説明も、コードブロックの記号も付けないでください。
+省略したい項目は、文字列なら空文字 ""、配列なら空配列 [] にしてください。
+
+{
+  "name": "アプリ名",
+  "description": "アプリの説明",
+  "theme": "WHITE | RED | GREEN | BLUE | YELLOW | BLACK",
+  "icon": "絵文字1文字",
+  "titleFieldCode": "レコードのタイトルに使うフィールド名",
+  "fields": [
+    {
+      "type": "フィールド型",
+      "label": "フィールド名",
+      "required": true,
+      "options": ["選択肢1", "選択肢2"],
+      "expression": "CALC の計算式",
+      "group": "意味のまとまりの名前"
+    }
+  ],
+  "views": [
+    { "name": "一覧名", "fields": ["フィールド名"] }
+  ]
+}`;
+/**
+ * 既存アプリを直すときに、システムプロンプトへ足す指示。
+ *
+ * 更新でいちばん壊れやすいのは「既存フィールドのコードが変わること」。
+ * コードが変わると別のフィールドとみなされ、追加 + 元は削除候補になり、
+ * データが新しいフィールドには入らない。ここを強く縛る。
+ */
+export const REVISE_INSTRUCTION = `
+
+## 既存アプリを直すときの決まり
+
+いま動いているアプリの設計を渡します。**変更後の完成形**を、全体として出力してください。
+差分ではなく、フィールドを 1 つも落とさずに、あるべき姿を丸ごと書きます。
+
+### 守ること
+
+- **既存フィールドの \`code\` は絶対に変えない。** 渡された \`code\` をそのまま書き写す。
+  ラベルを変えたい場合も \`code\` はそのまま。変えるとデータが引き継がれません。
+- 新しく足すフィールドだけ \`code\` を空文字にする。
+- **フィールドの型は後から変更できません。** 型を変えたい要望があっても、既存フィールドの
+  \`type\` は変えないこと。どうしても必要なら、新しいフィールドを足したうえで、
+  古いフィールドを出力から外す (外したフィールドは削除候補に移り、データは残ります)。
+- 変更を頼まれていないフィールドは、渡されたとおりに書き写す。勝手に消したり増やしたりしない。
+- **一覧 (views) も、変更を頼まれていなければ渡されたとおりに書き写す。**
+  並び順や絞り込み条件を勝手に足したり変えたりしない。
+- **フィールドを外したら、一覧 (views) の fields からも外す。** 残っていると検証で弾かれます。
+- 依頼が曖昧なときは、いま在るものを保つ方向に倒す。`;
+//# sourceMappingURL=prompt.js.map

package/dist/llm/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/llm/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;UAanB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAiC1B,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;+DAwBE,CAAC;AAEhE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BpC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;4BAmBN,CAAC"}

package/dist/spec/appSpec.js

@@ -0,0 +1,283 @@
+import { z } from "zod";
+import { DEFAULT_MAX_PER_ROW } from "./layout.js";
+import { deriveFieldCode, fieldSpecSchema, UNADDABLE_FIELD_TYPES, validateFieldCode, } from "./fieldSpec.js";
+export const APP_THEMES = [
+    "WHITE",
+    "RED",
+    "GREEN",
+    "BLUE",
+    "YELLOW",
+    "BLACK",
+];
+/** 一覧 (ビュー) の定義。v1 は一覧形式とカレンダー形式のみ扱う。 */
+export const viewSpecSchema = z
+    .object({
+    /** 一覧の名前。64 文字以内。 */
+    name: z.string().min(1).max(64),
+    type: z.enum(["LIST", "CALENDAR"]).default("LIST"),
+    /** LIST のとき表示するフィールドコード。省略時は全フィールドを表示する。 */
+    fields: z.array(z.string().min(1)).optional(),
+    /** CALENDAR のとき日付として使うフィールドコード。 */
+    date: z.string().min(1).optional(),
+    /** CALENDAR のときタイトルとして使うフィールドコード。 */
+    title: z.string().min(1).optional(),
+    /** 絞り込み条件 (kintone のクエリ形式)。例: `状態 in ("対応中")` */
+    filterCond: z.string().optional(),
+    /** 並び順 (kintone のクエリ形式)。例: `更新日時 desc` */
+    sort: z.string().optional(),
+    /** ページネーションを有効にするか。 */
+    pager: z.boolean().optional(),
+    device: z.enum(["DESKTOP", "ANY"]).optional(),
+})
+    .strict();
+/** アプリの一般設定。 */
+export const generalSettingsSchema = z
+    .object({
+    /** レコードのタイトルに使うフィールドコード。省略時は kintone の自動選択。 */
+    titleFieldCode: z.string().min(1).optional(),
+    enableComments: z.boolean().optional(),
+    enableThumbnails: z.boolean().optional(),
+    enableBulkDeletion: z.boolean().optional(),
+    enableDuplicateRecord: z.boolean().optional(),
+    enableInlineRecordEditing: z.boolean().optional(),
+    /** 年度の開始月 (1-12)。 */
+    firstMonthOfFiscalYear: z.number().int().min(1).max(12).optional(),
+})
+    .strict();
+const appSpecObjectSchema = z
+    .object({
+    /** アプリ名。kintone の上限に合わせて 64 文字以内。 */
+    name: z.string().min(1).max(64),
+    /** アプリの説明。kintone の上限に合わせて 10,000 文字以内。 */
+    description: z.string().max(10000).optional(),
+    theme: z.enum(APP_THEMES).optional(),
+    /**
+     * アプリアイコンにする絵文字、または頭文字 (1〜3 文字)。
+     * 画像を生成してアップロードし、アプリアイコンとして設定する。
+     * 省略した場合はアイコンを設定しない (kintone の既定アイコンのまま)。
+     */
+    icon: z.string().min(1).refine((value) => [...value].length <= 8, {
+        message: "icon は絵文字 1 文字か、短い頭文字で指定してください",
+    }).optional(),
+    /**
+     * アプリを作成するスペース ID。省略するとスペースに属さないアプリになる。
+     * CLI の --space を付けるとこちらより優先される。
+     */
+    space: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    /** スペース内のスレッド ID。kintone がスレッドの指定を求める場合に使う。 */
+    thread: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    /** ゲストスペース ID。ゲストスペースのアプリは API のパスが変わる。 */
+    guestSpaceId: z.union([z.number().int().positive(), z.string().min(1)]).optional(),
+    /** アイコンの背景色 (#rrggbb)。省略時はアプリ名から決まる。 */
+    iconBackground: z
+        .string()
+        .regex(/^#[0-9a-fA-F]{6}$/, "iconBackground は #rrggbb 形式で指定してください")
+        .optional(),
+    /** フィールド。配列の順序がそのままフォームの配置順になる。 */
+    fields: z.array(fieldSpecSchema).min(1, "フィールドを 1 つ以上指定してください"),
+    /**
+     * フォームの並べ方。
+     * `grouped` (既定) は、似た系統のフィールドを横に並べる。
+     * `stacked` はレイアウトに手を加えず、1 行 1 フィールドのままにする。
+     */
+    layout: z
+        .union([
+        z.enum(["grouped", "stacked"]),
+        z
+            .object({
+            mode: z.enum(["grouped", "stacked"]).default("grouped"),
+            /** 1 行に並べる上限。 */
+            maxPerRow: z.number().int().min(1).max(4).default(DEFAULT_MAX_PER_ROW),
+        })
+            .strict(),
+    ])
+        .optional(),
+    /** 一覧。省略した場合は既定の一覧に手を加えない。 */
+    views: z.array(viewSpecSchema).optional(),
+    settings: generalSettingsSchema.optional(),
+})
+    .strict();
+/**
+ * AppSpec のスキーマ。
+ * フィールドコードの重複や、一覧・一般設定から参照されるフィールドコードの存在確認まで含めて、
+ * kintone に 1 リクエストも投げる前に検出する。
+ */
+export const appSpecSchema = appSpecObjectSchema.superRefine((spec, ctx) => {
+    const codes = new Set();
+    spec.fields.forEach((field, index) => {
+        const code = resolveFieldCode(field);
+        const issue = validateFieldCode(code);
+        if (issue) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["fields", index, field.code === undefined ? "label" : "code"],
+                message: field.code === undefined
+                    ? `label から導出したフィールドコード "${code}" が不正です: ${issue.reason}`
+                    : issue.reason,
+            });
+            return;
+        }
+        if (codes.has(code)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["fields", index, "code"],
+                message: `フィールドコード "${code}" が重複しています`,
+            });
+        }
+        codes.add(code);
+    });
+    spec.views?.forEach((view, index) => {
+        const referenced = [
+            ["date", view.date],
+            ["title", view.title],
+        ];
+        for (const [key, code] of referenced) {
+            if (code !== undefined && !codes.has(code)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ["views", index, key],
+                    message: `フィールドコード "${code}" は fields に存在しません`,
+                });
+            }
+        }
+        view.fields?.forEach((code, fieldIndex) => {
+            if (!codes.has(code) && !BUILT_IN_FIELD_CODES.has(code)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ["views", index, "fields", fieldIndex],
+                    message: `フィールドコード "${code}" は fields に存在しません`,
+                });
+            }
+        });
+        if (view.type === "CALENDAR" && view.date === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["views", index, "date"],
+                message: "CALENDAR 形式の一覧には date が必要です",
+            });
+        }
+    });
+    const titleFieldCode = spec.settings?.titleFieldCode;
+    if (titleFieldCode !== undefined && !codes.has(titleFieldCode)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["settings", "titleFieldCode"],
+            message: `フィールドコード "${titleFieldCode}" は fields に存在しません`,
+        });
+    }
+    // 同じ group が離れて書かれていると、まとまらずに散らばった行になる。
+    // 気付きにくいので、デプロイ前に指摘する。
+    const seenGroups = new Map();
+    let previousGroup;
+    spec.fields.forEach((field, index) => {
+        const group = field.group;
+        if (group !== undefined && group !== previousGroup && seenGroups.has(group)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["fields", index, "group"],
+                message: `group "${group}" のフィールドが離れて書かれています ` +
+                    `(${seenGroups.get(group) + 1} 番目のフィールドにも同じ group があります)。` +
+                    " 同じ group のフィールドは続けて並べてください。",
+            });
+        }
+        if (group !== undefined)
+            seenGroups.set(group, index);
+        previousGroup = group;
+    });
+    const viewNames = new Set();
+    spec.views?.forEach((view, index) => {
+        if (viewNames.has(view.name)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["views", index, "name"],
+                message: `一覧名 "${view.name}" が重複しています`,
+            });
+        }
+        viewNames.add(view.name);
+    });
+});
+/** アプリ作成時に自動生成され、一覧に指定できる組み込みフィールドコード。 */
+export const BUILT_IN_FIELD_CODES = new Set([
+    "レコード番号",
+    "作成者",
+    "作成日時",
+    "更新者",
+    "更新日時",
+    "Record_number",
+    "Created_by",
+    "Created_datetime",
+    "Updated_by",
+    "Updated_datetime",
+]);
+/** フィールドの実効コードを返す (未指定なら label から導出)。 */
+export function resolveFieldCode(field) {
+    return field.code ?? deriveFieldCode(field.label);
+}
+/** AppSpec に対する検証エラー。どのパスで何が起きたかを人が読める形で保持する。 */
+export class AppSpecValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = "AppSpecValidationError";
+    }
+}
+/**
+ * 任意の入力を AppSpec として検証する。
+ * サポート外のフィールド型は Zod のメッセージだけだと理由が伝わらないため、
+ * 先に既知の「追加できない型」を検出して個別のメッセージを出す。
+ */
+export function parseAppSpec(input) {
+    const preIssues = detectUnsupportedFieldTypes(input);
+    if (preIssues.length > 0) {
+        throw new AppSpecValidationError("AppSpec の検証に失敗しました", preIssues);
+    }
+    const result = appSpecSchema.safeParse(input);
+    if (!result.success) {
+        throw new AppSpecValidationError("AppSpec の検証に失敗しました", result.error.issues.map((issue) => ({
+            path: issue.path.length > 0 ? issue.path.join(".") : "(root)",
+            message: issue.message,
+        })));
+    }
+    return result.data;
+}
+function detectUnsupportedFieldTypes(input) {
+    if (typeof input !== "object" || input === null)
+        return [];
+    const fields = input.fields;
+    if (!Array.isArray(fields))
+        return [];
+    const issues = [];
+    fields.forEach((field, index) => {
+        if (typeof field !== "object" || field === null)
+            return;
+        const type = field.type;
+        if (typeof type !== "string")
+            return;
+        const reason = UNADDABLE_FIELD_TYPES[type];
+        if (reason !== undefined) {
+            issues.push({ path: `fields.${index}.type`, message: `${type}: ${reason}` });
+        }
+    });
+    return issues;
+}
+/** フィールドコード → group の対応。レイアウトの組み立てに渡す。 */
+export function fieldGroups(spec) {
+    const groups = {};
+    for (const field of spec.fields) {
+        if (field.group !== undefined) {
+            groups[resolveFieldCode(field)] = field.group;
+        }
+    }
+    return groups;
+}
+/** layout の指定を、扱いやすい形に正規化する。 */
+export function resolveLayout(spec) {
+    const layout = spec.layout;
+    if (layout === undefined)
+        return { mode: "grouped", maxPerRow: DEFAULT_MAX_PER_ROW };
+    if (typeof layout === "string")
+        return { mode: layout, maxPerRow: DEFAULT_MAX_PER_ROW };
+    return { mode: layout.mode, maxPerRow: layout.maxPerRow };
+}
+//# sourceMappingURL=appSpec.js.map

package/dist/spec/appSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appSpec.js","sourceRoot":"","sources":["../../src/spec/appSpec.ts"],"names":[],"mappings":"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"}

package/dist/spec/diff.js

@@ -0,0 +1,218 @@
+import { fieldGroups, resolveFieldCode, resolveLayout } from "./appSpec.js";
+/** 変更が 1 つも無いか。 */
+export function isEmptyDiff(diff) {
+    return (diff.added.length === 0 &&
+        diff.updated.length === 0 &&
+        diff.retyped.length === 0 &&
+        diff.orphaned.length === 0 &&
+        diff.app.length === 0 &&
+        diff.views.added.length === 0 &&
+        diff.views.updated.length === 0 &&
+        diff.views.removed.length === 0 &&
+        // 適用されない並びの違いは、差分として数えない (何も起きないため)。
+        !diff.layout.willApply);
+}
+/** 目標に近づけるために kintone を変更する必要があるか (削除候補への退避も変更に含む)。 */
+export function hasWork(diff) {
+    return !isEmptyDiff(diff);
+}
+export function diffAppSpec(current, desired) {
+    const currentFields = byCode(current.fields);
+    const desiredFields = byCode(desired.fields);
+    const added = [];
+    const updated = [];
+    const retyped = [];
+    const orphaned = [];
+    for (const [code, field] of desiredFields) {
+        const existing = currentFields.get(code);
+        if (existing === undefined) {
+            added.push({ code, field });
+            continue;
+        }
+        if (existing.type !== field.type) {
+            // kintone は作成後の型を変えられない。呼び出し側で扱いを決めてもらう。
+            retyped.push({ code, from: existing.type, to: field.type });
+            continue;
+        }
+        const changes = compareFields(existing, field);
+        if (changes.length > 0) {
+            updated.push({ code, field, changes });
+        }
+    }
+    for (const [code, field] of currentFields) {
+        if (!desiredFields.has(code)) {
+            orphaned.push({ code, type: field.type, label: field.label });
+        }
+    }
+    return {
+        added,
+        updated,
+        retyped,
+        orphaned,
+        app: compareAppSettings(current, desired),
+        views: compareViews(current.views ?? [], desired.views ?? []),
+        layout: compareLayout(current, desired),
+    };
+}
+function compareLayout(current, desired) {
+    const currentLayout = resolveLayout(current);
+    const desiredLayout = resolveLayout(desired);
+    const describe = (layout) => layout.mode === "grouped" ? `grouped (最大 ${layout.maxPerRow} 列)` : "stacked";
+    const currentCodes = current.fields.map(resolveFieldCode);
+    const desiredCodes = desired.fields.map(resolveFieldCode);
+    const shared = new Set(currentCodes.filter((code) => desiredCodes.includes(code)));
+    const orderChanged = JSON.stringify(currentCodes.filter((code) => shared.has(code))) !==
+        JSON.stringify(desiredCodes.filter((code) => shared.has(code)));
+    const currentGroups = fieldGroups(current);
+    const desiredGroups = fieldGroups(desired);
+    const groupsChanged = [...shared].some((code) => currentGroups[code] !== desiredGroups[code]);
+    const modeChanged = currentLayout.mode !== desiredLayout.mode || currentLayout.maxPerRow !== desiredLayout.maxPerRow;
+    return {
+        from: describe(currentLayout),
+        to: describe(desiredLayout),
+        modeChanged,
+        orderChanged,
+        groupsChanged,
+        // stacked は「既存の並びに手を触れない」指定なので、違いがあっても組み直さない。
+        willApply: desiredLayout.mode === "grouped" && (modeChanged || orderChanged || groupsChanged),
+    };
+}
+function byCode(fields) {
+    return new Map(fields.map((field) => [resolveFieldCode(field), field]));
+}
+/**
+ * フィールドの設定を比べる。
+ * `code` と `group` は比較から外す — 前者は同一性の鍵、
+ * 後者はレイアウトの都合で kintone には送らない情報なので。
+ *
+ * **AppSpec で書かれていない項目は「現状維持」として扱う。**
+ * kintone の設定変更 API は省略した項目を変えないので、
+ * 「現状にはあるが目標には書かれていない」を変更として報告すると、
+ * 実際には何も起きないのに差分が永遠に消えないことになる。
+ * 値を変えたいときは、明示的に書く (例: `"required": false`)。
+ */
+const FIELD_KEYS_TO_IGNORE = new Set(["code", "type", "group"]);
+function compareFields(current, desired) {
+    const keys = new Set([
+        ...Object.keys(current).filter((key) => !FIELD_KEYS_TO_IGNORE.has(key)),
+        ...Object.keys(desired).filter((key) => !FIELD_KEYS_TO_IGNORE.has(key)),
+    ]);
+    const changes = [];
+    for (const key of [...keys].sort()) {
+        const from = current[key];
+        const to = desired[key];
+        if (to === undefined)
+            continue;
+        if (!same(from, to)) {
+            changes.push({ key, from, to });
+        }
+    }
+    return changes;
+}
+function compareAppSettings(current, desired) {
+    const changes = [];
+    // 未指定は「現状維持」。書かれていない項目は送らないので、差分にもしない。
+    for (const key of ["name", "description", "theme", "icon", "iconBackground"]) {
+        if (desired[key] === undefined)
+            continue;
+        if (!same(current[key], desired[key])) {
+            changes.push({ key, from: current[key], to: desired[key] });
+        }
+    }
+    const currentSettings = (current.settings ?? {});
+    const desiredSettings = (desired.settings ?? {});
+    for (const key of [...new Set([...Object.keys(currentSettings), ...Object.keys(desiredSettings)])].sort()) {
+        if (desiredSettings[key] === undefined)
+            continue;
+        if (!same(currentSettings[key], desiredSettings[key])) {
+            changes.push({ key: `settings.${key}`, from: currentSettings[key], to: desiredSettings[key] });
+        }
+    }
+    return changes;
+}
+/** 一覧は名前で対応付ける。 */
+function compareViews(current, desired) {
+    const currentByName = new Map(current.map((view) => [view.name, view]));
+    const desiredByName = new Map(desired.map((view) => [view.name, view]));
+    const added = [];
+    const updated = [];
+    for (const [name, view] of desiredByName) {
+        const existing = currentByName.get(name);
+        if (existing === undefined) {
+            added.push(view);
+            continue;
+        }
+        const changes = [];
+        const keys = new Set([...Object.keys(existing), ...Object.keys(view)]);
+        for (const key of [...keys].sort()) {
+            if (key === "name")
+                continue;
+            const from = existing[key];
+            const to = view[key];
+            if (!same(from, to))
+                changes.push({ key, from, to });
+        }
+        if (changes.length > 0)
+            updated.push({ name, view, changes });
+    }
+    const removed = [...currentByName.keys()].filter((name) => !desiredByName.has(name));
+    return { added, updated, removed };
+}
+/**
+ * 値を比べる。
+ *
+ * 真偽値の設定は kintone の既定が false なので、**未指定と false は同じ**とみなす。
+ * ここを分けると「required を書いていないフィールド」と
+ * 「required: false と書いたフィールド」が毎回差分になり、無意味な変更が出続ける。
+ */
+function same(a, b) {
+    if (a === b)
+        return true;
+    if (a === undefined)
+        return b === false;
+    if (b === undefined)
+        return a === false;
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/** 差分を人が読める行にする。 */
+export function describeDiff(diff) {
+    const lines = [];
+    const show = (value) => value === undefined ? "(なし)" : typeof value === "string" ? value : JSON.stringify(value);
+    for (const change of diff.app) {
+        lines.push(`  ~ ${change.key}: ${show(change.from)} → ${show(change.to)}`);
+    }
+    for (const addition of diff.added) {
+        lines.push(`  + ${addition.code} (${addition.field.type}) を追加`);
+    }
+    for (const update of diff.updated) {
+        const detail = update.changes
+            .map((change) => `${change.key}: ${show(change.from)} → ${show(change.to)}`)
+            .join(", ");
+        lines.push(`  ~ ${update.code}: ${detail}`);
+    }
+    for (const retype of diff.retyped) {
+        lines.push(`  ! ${retype.code}: 型を ${retype.from} → ${retype.to} に変更 (kintone では不可)`);
+    }
+    for (const orphan of diff.orphaned) {
+        lines.push(`  - ${orphan.code} (${orphan.type}) を削除候補へ`);
+    }
+    if (diff.layout.willApply) {
+        const reasons = [
+            diff.layout.modeChanged ? `指定: ${diff.layout.from} → ${diff.layout.to}` : null,
+            diff.layout.orderChanged ? "並び順" : null,
+            diff.layout.groupsChanged ? "group" : null,
+        ].filter((reason) => reason !== null);
+        lines.push(`  ~ フォームの並びを組み直す (${reasons.join(", ")})`);
+    }
+    for (const view of diff.views.added) {
+        lines.push(`  + 一覧「${view.name}」を追加`);
+    }
+    for (const view of diff.views.updated) {
+        lines.push(`  ~ 一覧「${view.name}」: ${view.changes.map((c) => c.key).join(", ")}`);
+    }
+    for (const name of diff.views.removed) {
+        lines.push(`  - 一覧「${name}」を削除`);
+    }
+    return lines;
+}
+//# sourceMappingURL=diff.js.map