@interactive-inc/docs-client 0.0.9 → 0.0.10

package/build/index.js

@@ -1,5 +1,5 @@
 // lib/models.ts
-import { z } from "zod/v4";
+import { z } from "zod";
 var zDocFilePath = z.object({
   name: z.string(),
   path: z.string(),
@@ -150,6 +150,11 @@ var zDocFileMdFrontMatter = z.record(
   ])
 );
 var zDocSchema = z.record(z.string(), zDocSchemaField);
+var zDocSchemaFieldMinimal = z.object({
+  type: zDocSchemaFieldType,
+  required: z.boolean()
+});
+var zDocSchemaMinimal = z.record(z.string(), zDocSchemaFieldMinimal);
 var zDocFileIndexFrontMatter = z.object({
   type: z.literal("index-frontmatter"),
   icon: z.string(),
@@ -829,16 +834,16 @@ var DocSchemaFieldNumberSingleValue = class {
   }
 };
 
-// lib/values/doc-schema-field-relation-multiple-value.ts
-var DocSchemaFieldRelationMultipleValue = class {
+// lib/values/doc-schema-field-text-multiple-value.ts
+var DocSchemaFieldTextMultipleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
+    Object.freeze(this);
     Object.freeze(this.value);
-    if (this.value.default && Array.isArray(this.value.default)) {
+    if (this.value.default) {
       Object.freeze(this.value.default);
     }
-    Object.freeze(this);
   }
   get type() {
     return this.value.type;
@@ -855,25 +860,22 @@ var DocSchemaFieldRelationMultipleValue = class {
   get default() {
     return this.value.default;
   }
-  get path() {
-    return this.value.path;
-  }
   isArray = true;
   isSingle = false;
-  isRelation = true;
+  isText = true;
+  toJson() {
+    return { ...this.value };
+  }
   /**
-   * 値を検証する
+   * 値の型を検証する
    */
   validate(value) {
     return Array.isArray(value) && value.every((v) => typeof v === "string");
   }
-  toJson() {
-    return { ...this.value };
-  }
 };
 
-// lib/values/doc-schema-field-relation-single-value.ts
-var DocSchemaFieldRelationSingleValue = class {
+// lib/values/doc-schema-field-text-single-value.ts
+var DocSchemaFieldTextSingleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
@@ -894,12 +896,9 @@ var DocSchemaFieldRelationSingleValue = class {
   get default() {
     return this.value.default;
   }
-  get path() {
-    return this.value.path;
-  }
   isArray = false;
   isSingle = true;
-  isRelation = true;
+  isText = true;
   toJson() {
     return { ...this.value };
   }
@@ -911,17 +910,142 @@ var DocSchemaFieldRelationSingleValue = class {
   }
 };
 
-// lib/values/doc-schema-field-select-number-multiple-value.ts
-var DocSchemaFieldSelectNumberMultipleValue = class {
+// lib/values/doc-schema-builder.ts
+import { z as z2 } from "zod";
+var DocSchemaBuilder = class {
+  /**
+   * 動的にZodスキーマを生成
+   */
+  createDynamicSchema(value) {
+    if (typeof value !== "object" || value === null) {
+      throw new Error("Schema must be an object");
+    }
+    const schemaObj = value;
+    const zodFields = {};
+    for (const [key, field] of Object.entries(schemaObj)) {
+      if (typeof field !== "object" || field === null) {
+        throw new Error(`Field "${key}" must be an object`);
+      }
+      const fieldObj = field;
+      if (!("type" in fieldObj) || !("required" in fieldObj)) {
+        throw new Error(
+          `Field "${key}" must have "type" and "required" properties`
+        );
+      }
+      try {
+        zDocSchemaFieldMinimal.parse(fieldObj);
+      } catch (error) {
+        if (error instanceof Error) {
+          throw new Error(`Field "${key}": ${error.message}`);
+        }
+        throw error;
+      }
+      zodFields[key] = this.createFieldSchema(fieldObj.type);
+    }
+    return z2.object(zodFields);
+  }
+  /**
+   * フィールドタイプに応じたZodスキーマを生成
+   */
+  createFieldSchema(type) {
+    const baseSchema = {
+      type: z2.literal(type),
+      required: z2.boolean(),
+      title: z2.string().nullable().optional(),
+      description: z2.string().nullable().optional()
+    };
+    if (type === "text") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.string().nullable().default("")
+      });
+    }
+    if (type === "number") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.number().nullable().default(0)
+      });
+    }
+    if (type === "boolean") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.boolean().nullable().default(false)
+      });
+    }
+    if (type === "multi-text") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.array(z2.string()).default([])
+      });
+    }
+    if (type === "multi-number") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.array(z2.number()).default([])
+      });
+    }
+    if (type === "multi-boolean") {
+      return z2.object({
+        ...baseSchema,
+        default: z2.array(z2.boolean()).default([])
+      });
+    }
+    if (type === "relation") {
+      return z2.object({
+        ...baseSchema,
+        path: z2.string().min(1),
+        default: z2.string().nullable().default(null)
+      });
+    }
+    if (type === "multi-relation") {
+      return z2.object({
+        ...baseSchema,
+        path: z2.string().min(1),
+        default: z2.array(z2.string()).nullable().default(null)
+      });
+    }
+    if (type === "select-text") {
+      return z2.object({
+        ...baseSchema,
+        options: z2.array(z2.string()),
+        default: z2.string().nullable().default(null)
+      });
+    }
+    if (type === "select-number") {
+      return z2.object({
+        ...baseSchema,
+        options: z2.array(z2.number()),
+        default: z2.number().nullable().default(null)
+      });
+    }
+    if (type === "multi-select-text") {
+      return z2.object({
+        ...baseSchema,
+        options: z2.array(z2.string()),
+        default: z2.array(z2.string()).nullable().default(null)
+      });
+    }
+    if (type === "multi-select-number") {
+      return z2.object({
+        ...baseSchema,
+        options: z2.array(z2.number()),
+        default: z2.array(z2.number()).nullable().default(null)
+      });
+    }
+    throw new Error(`Unknown field type: ${type}`);
+  }
+};
+
+// lib/values/doc-schema-field-relation-multiple-value.ts
+var DocSchemaFieldRelationMultipleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
-    Object.freeze(this);
     Object.freeze(this.value);
-    Object.freeze(this.value.options);
     if (this.value.default && Array.isArray(this.value.default)) {
       Object.freeze(this.value.default);
     }
+    Object.freeze(this);
   }
   get type() {
     return this.value.type;
@@ -938,32 +1062,29 @@ var DocSchemaFieldSelectNumberMultipleValue = class {
   get default() {
     return this.value.default;
   }
-  get options() {
-    return this.value.options;
+  get path() {
+    return this.value.path;
   }
   isArray = true;
   isSingle = false;
-  isSelect = true;
-  isNumberSelect = true;
+  isRelation = true;
   /**
    * 値を検証する
    */
   validate(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === "number");
+    return Array.isArray(value) && value.every((v) => typeof v === "string");
   }
   toJson() {
     return { ...this.value };
   }
 };
 
-// lib/values/doc-schema-field-select-number-single-value.ts
-var DocSchemaFieldSelectNumberSingleValue = class {
+// lib/values/doc-schema-field-relation-single-value.ts
+var DocSchemaFieldRelationSingleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
     Object.freeze(this);
-    Object.freeze(this.value);
-    Object.freeze(this.value.options);
   }
   get type() {
     return this.value.type;
@@ -980,26 +1101,25 @@ var DocSchemaFieldSelectNumberSingleValue = class {
   get default() {
     return this.value.default;
   }
-  get options() {
-    return this.value.options;
+  get path() {
+    return this.value.path;
   }
   isArray = false;
   isSingle = true;
-  isSelect = true;
-  isNumberSelect = true;
+  isRelation = true;
+  toJson() {
+    return { ...this.value };
+  }
   /**
-   * 値を検証する
+   * 値の型を検証する
    */
   validate(value) {
-    return typeof value === "number";
-  }
-  toJson() {
-    return { ...this.value };
+    return typeof value === "string";
   }
 };
 
-// lib/values/doc-schema-field-select-text-multiple-value.ts
-var DocSchemaFieldSelectTextMultipleValue = class {
+// lib/values/doc-schema-field-select-number-multiple-value.ts
+var DocSchemaFieldSelectNumberMultipleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
@@ -1031,28 +1151,26 @@ var DocSchemaFieldSelectTextMultipleValue = class {
   isArray = true;
   isSingle = false;
   isSelect = true;
-  isTextSelect = true;
+  isNumberSelect = true;
   /**
    * 値を検証する
    */
   validate(value) {
-    return Array.isArray(value) && value.every((v) => typeof v === "string");
+    return Array.isArray(value) && value.every((v) => typeof v === "number");
   }
   toJson() {
     return { ...this.value };
   }
 };
 
-// lib/values/doc-schema-field-select-text-single-value.ts
-var DocSchemaFieldSelectTextSingleValue = class {
+// lib/values/doc-schema-field-select-number-single-value.ts
+var DocSchemaFieldSelectNumberSingleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
-    if (this.value.options) {
-      Object.freeze(this.value.options);
-    }
-    Object.freeze(this.value);
     Object.freeze(this);
+    Object.freeze(this.value);
+    Object.freeze(this.value.options);
   }
   get type() {
     return this.value.type;
@@ -1075,26 +1193,27 @@ var DocSchemaFieldSelectTextSingleValue = class {
   isArray = false;
   isSingle = true;
   isSelect = true;
-  isTextSelect = true;
-  toJson() {
-    return { ...this.value };
-  }
+  isNumberSelect = true;
   /**
-   * 値の型を検証する
+   * 値を検証する
    */
   validate(value) {
-    return typeof value === "string";
+    return typeof value === "number";
+  }
+  toJson() {
+    return { ...this.value };
   }
 };
 
-// lib/values/doc-schema-field-text-multiple-value.ts
-var DocSchemaFieldTextMultipleValue = class {
+// lib/values/doc-schema-field-select-text-multiple-value.ts
+var DocSchemaFieldSelectTextMultipleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
     Object.freeze(this);
     Object.freeze(this.value);
-    if (this.value.default) {
+    Object.freeze(this.value.options);
+    if (this.value.default && Array.isArray(this.value.default)) {
       Object.freeze(this.value.default);
     }
   }
@@ -1113,25 +1232,33 @@ var DocSchemaFieldTextMultipleValue = class {
   get default() {
     return this.value.default;
   }
+  get options() {
+    return this.value.options;
+  }
   isArray = true;
   isSingle = false;
-  isText = true;
-  toJson() {
-    return { ...this.value };
-  }
+  isSelect = true;
+  isTextSelect = true;
   /**
-   * 値の型を検証する
+   * 値を検証する
    */
   validate(value) {
     return Array.isArray(value) && value.every((v) => typeof v === "string");
   }
+  toJson() {
+    return { ...this.value };
+  }
 };
 
-// lib/values/doc-schema-field-text-single-value.ts
-var DocSchemaFieldTextSingleValue = class {
+// lib/values/doc-schema-field-select-text-single-value.ts
+var DocSchemaFieldSelectTextSingleValue = class {
   constructor(key, value) {
     this.key = key;
     this.value = value;
+    if (this.value.options) {
+      Object.freeze(this.value.options);
+    }
+    Object.freeze(this.value);
     Object.freeze(this);
   }
   get type() {
@@ -1149,9 +1276,13 @@ var DocSchemaFieldTextSingleValue = class {
   get default() {
     return this.value.default;
   }
+  get options() {
+    return this.value.options;
+  }
   isArray = false;
   isSingle = true;
-  isText = true;
+  isSelect = true;
+  isTextSelect = true;
   toJson() {
     return { ...this.value };
   }
@@ -1402,101 +1533,367 @@ var DocSchemaFieldFactory = class {
   }
 };
 
-// lib/values/doc-front-matter-md-value.ts
-var DocFrontMatterMdValue = class _DocFrontMatterMdValue {
-  constructor(value) {
-    this.value = value;
-    zDocFileMdFrontMatter.parse(value);
+// lib/values/doc-schema-value.ts
+var DocSchemaValue = class _DocSchemaValue {
+  value;
+  zodSchema;
+  constructor(value, zodSchema, schemaBuilder) {
+    this.zodSchema = zodSchema || null;
+    const builder = schemaBuilder || new DocSchemaBuilder();
+    if (this.zodSchema) {
+      const parsed = this.zodSchema.parse(value);
+      this.value = _DocSchemaValue.normalizeSchema(parsed);
+    } else {
+      const dynamicSchema = builder.createDynamicSchema(value);
+      const parsed = dynamicSchema.parse(value);
+      this.value = _DocSchemaValue.normalizeSchema(parsed);
+    }
+    zDocSchema.parse(this.value);
+    Object.freeze(this.value);
     Object.freeze(this);
   }
-  toJson() {
-    return this.value;
-  }
-  toYaml() {
-    return stringify2(this.value).trim();
-  }
   /**
-   * Markdownテキストから生成
+   * フィールド名の一覧を取得
+   * Zodスキーマを使用している場合は自動的に型安全
    */
-  static from(markdownText) {
-    const openMarkdown = new DocContentMdValue(markdownText);
-    const rawData = openMarkdown.frontMatter.data || {};
-    const data = zDocFileMdFrontMatter.parse(rawData);
-    return new _DocFrontMatterMdValue(data);
+  get fieldNames() {
+    return Object.keys(this.value);
+  }
+  field(name) {
+    const fieldDef = this.value[name];
+    if (fieldDef === void 0) {
+      return null;
+    }
+    const factory = new DocSchemaFieldFactory();
+    return factory.fromUnknown(name, fieldDef);
   }
   /**
-   * 空のFrontMatterを生成
+   * すべてのフィールドを取得
+   * 注意: 型安全性のため、個別にfield()メソッドを使用することを推奨
    */
-  static empty() {
-    return new _DocFrontMatterMdValue({});
+  get fields() {
+    const factory = new DocSchemaFieldFactory();
+    return this.fieldNames.map((name) => {
+      const fieldValue = this.value[name];
+      if (!fieldValue) {
+        throw new Error(`Field ${name} not found in schema`);
+      }
+      return factory.fromUnknown(name, fieldValue);
+    });
+  }
+  get relationFields() {
+    return this.fields.filter((t) => {
+      return t instanceof DocSchemaFieldRelationSingleValue || t instanceof DocSchemaFieldRelationMultipleValue;
+    });
   }
   /**
-   * データから直接生成
+   * 空のスキーマエンティティを作成
    */
-  static fromData(data) {
-    const validatedData = zDocFileMdFrontMatter.parse(data);
-    return new _DocFrontMatterMdValue(validatedData);
+  static empty(zodSchema, dynamicBuilder) {
+    return new _DocSchemaValue({}, zodSchema, dynamicBuilder);
   }
   /**
-   * スキーマフィールドに基づいてデフォルト値を生成する
+   * スキーマからリレーションパスを抽出
    */
-  static generateDefaultValueFromSchemaField(fieldDef) {
-    if (fieldDef.type === "text") {
-      return fieldDef.default ?? "";
-    }
-    if (fieldDef.type === "boolean") {
-      return fieldDef.default ?? false;
-    }
-    if (fieldDef.type === "number") {
-      return fieldDef.default ?? 0;
-    }
-    if (fieldDef.type === "multi-text" || fieldDef.type === "multi-number" || fieldDef.type === "multi-boolean" || fieldDef.type === "multi-relation") {
-      return fieldDef.default ?? [];
-    }
-    if (fieldDef.type === "relation") {
-      return fieldDef.default ?? null;
+  extractRelationPaths() {
+    if (!this.value) return /* @__PURE__ */ new Set();
+    const uniqueRelationPaths = /* @__PURE__ */ new Set();
+    for (const field of Object.values(this.value)) {
+      if (this.isRelationField(field) && "path" in field) {
+        uniqueRelationPaths.add(field.path);
+      }
     }
-    return null;
+    return uniqueRelationPaths;
   }
   /**
-   * 単一のプロパティを更新した新しいインスタンスを返す
-   * スキーマに基づいて型を検証し、スキーマのフィールドのみを含む新しいインスタンスを生成
+   * フィールドがリレーション型かどうかを判定
    */
-  withProperty(key, value, schema) {
-    const currentData = this.toJson();
-    const fieldValue = schema.field(key);
-    if (fieldValue === null) {
-      return this;
+  isRelationField(field) {
+    return field.type === "relation" || field.type === "multi-relation";
+  }
+  /**
+   * リレーションオプションを作成
+   */
+  createRelationOption(filePath, title) {
+    const fileName = this.extractFileName(filePath);
+    return zDocRelationFile.parse({
+      name: fileName,
+      label: title || fileName,
+      value: fileName,
+      path: filePath
+    });
+  }
+  /**
+   * ファイルをスキップすべきかどうかを判定
+   */
+  shouldSkipFile(filePath) {
+    return filePath.endsWith("index.md") || filePath.endsWith("README.md");
+  }
+  /**
+   * 値を指定された型に変換する（デフォルト値フォールバック付き）
+   */
+  convertValue(value, targetType, defaultValue) {
+    if (this.isNullOrUndefined(value)) {
+      return defaultValue;
     }
-    if (!this.validateFieldValue(key, value, fieldValue)) {
-      return this;
+    try {
+      return this.convertByType(value, targetType, defaultValue);
+    } catch {
+      return defaultValue;
+    }
+  }
+  /**
+   * 型別の変換処理
+   */
+  convertByType(value, targetType, defaultValue) {
+    if (targetType === "text") {
+      return this.convertToString(value, defaultValue);
+    }
+    if (targetType === "number") {
+      return this.convertToNumber(value, defaultValue);
+    }
+    if (targetType === "boolean") {
+      return this.convertToBoolean(value, defaultValue);
+    }
+    if (targetType === "multi-text" || targetType === "array") {
+      return this.convertToArray(value, defaultValue);
+    }
+    if (targetType === "relation") {
+      return this.convertToRelation(value, defaultValue);
+    }
+    if (targetType === "multi-relation") {
+      return this.convertToMultiRelation(value, defaultValue);
+    }
+    return defaultValue;
+  }
+  /**
+   * 文字列型への変換
+   */
+  convertToString(value, defaultValue) {
+    if (typeof value === "string") return value;
+    if (typeof value === "number") return String(value);
+    if (typeof value === "boolean") return String(value);
+    return defaultValue;
+  }
+  /**
+   * 数値型への変換
+   */
+  convertToNumber(value, defaultValue) {
+    if (typeof value === "number") return value;
+    if (typeof value === "string") {
+      const parsed = Number(value);
+      return Number.isNaN(parsed) ? defaultValue : parsed;
+    }
+    if (typeof value === "boolean") return value ? 1 : 0;
+    return defaultValue;
+  }
+  /**
+   * ブール型への変換
+   */
+  convertToBoolean(value, defaultValue) {
+    if (typeof value === "boolean") return value;
+    if (typeof value === "string") {
+      const lower = value.toLowerCase();
+      if (lower === "true" || lower === "1") return true;
+      if (lower === "false" || lower === "0") return false;
+      return defaultValue;
+    }
+    if (typeof value === "number") return value !== 0;
+    return defaultValue;
+  }
+  /**
+   * 配列型への変換
+   */
+  convertToArray(value, defaultValue) {
+    if (Array.isArray(value)) return value;
+    if (typeof value === "string") {
+      return value.split(",").map((item) => item.trim());
+    }
+    return defaultValue;
+  }
+  /**
+   * リレーション型への変換
+   */
+  convertToRelation(value, defaultValue) {
+    if (typeof value === "string") {
+      return this.extractFileNameFromPath(value);
+    }
+    return defaultValue;
+  }
+  /**
+   * マルチリレーション型への変換
+   */
+  convertToMultiRelation(value, defaultValue) {
+    if (Array.isArray(value)) {
+      return value.filter((item) => typeof item === "string").map((item) => this.extractFileNameFromPath(item));
+    }
+    if (typeof value === "string") {
+      return value.split(",").map((item) => this.extractFileNameFromPath(item.trim()));
+    }
+    return defaultValue;
+  }
+  /**
+   * パスからファイル名を抽出（拡張子除去）
+   */
+  extractFileNameFromPath(path) {
+    const fileName = path.split("/").pop() || path;
+    return fileName.replace(/\.md$/, "");
+  }
+  /**
+   * スキーマベースでFrontMatterを補完する
+   */
+  getCompleteFrontMatter(rawFrontMatter) {
+    const defaultFrontMatter = this.generateDefaultFrontMatter();
+    return this.mergePreservingExistingValues(
+      defaultFrontMatter,
+      rawFrontMatter
+    );
+  }
+  /**
+   * 型安全にFrontMatterを補完する（Zodスキーマを使用している場合）
+   */
+  getTypedCompleteFrontMatter(rawFrontMatter) {
+    if (!this.zodSchema) {
+      throw new Error("Typed method requires a Zod schema");
+    }
+    const defaultFrontMatter = this.generateDefaultFrontMatter();
+    const merged = this.mergePreservingExistingValues(
+      defaultFrontMatter,
+      rawFrontMatter
+    );
+    return this.zodSchema.parse(merged);
+  }
+  /**
+   * スキーマからデフォルトFrontMatterを生成
+   */
+  generateDefaultFrontMatter() {
+    if (!this.value) return {};
+    const defaultFrontMatter = {};
+    for (const [key, field] of Object.entries(this.value)) {
+      defaultFrontMatter[key] = DocFrontMatterMdValue.generateDefaultValueFromSchemaField(field);
     }
-    const draft = {};
-    for (const field of schema.fields) {
-      const fieldKey = field.key;
-      if (fieldKey === key) {
-        draft[fieldKey] = value;
-      } else if (fieldKey in currentData) {
-        const value2 = currentData[fieldKey];
-        if (value2 !== void 0) {
-          draft[fieldKey] = value2;
+    return zDocFileMdFrontMatter.parse(defaultFrontMatter);
+  }
+  /**
+   * 既存の値を保持しながらマージ
+   */
+  mergePreservingExistingValues(defaults, existing) {
+    const result = { ...defaults };
+    if (existing && typeof existing === "object") {
+      const validatedData = zDocFileMdFrontMatter.parse(existing);
+      for (const [key, value] of Object.entries(validatedData)) {
+        if (value !== void 0 && value !== null) {
+          result[key] = value;
         }
-      } else {
-        draft[fieldKey] = field.toJson().default;
       }
     }
-    return new _DocFrontMatterMdValue(draft);
+    return result;
+  }
+  /**
+   * ファイルパスからファイル名を抽出（拡張子なし）
+   */
+  extractFileName(filePath) {
+    return filePath.split("/").pop()?.replace(".md", "") || filePath;
+  }
+  /**
+   * nullまundefinedのチェック
+   */
+  isNullOrUndefined(value) {
+    return value === null || value === void 0;
+  }
+  toJson() {
+    return this.value;
+  }
+  /**
+   * スキーマを正規化（エラーを出すように変更）
+   */
+  static normalizeSchema(schema) {
+    if (typeof schema !== "object" || schema === null) {
+      throw new Error("Schema must be an object");
+    }
+    const normalized = {};
+    const factory = new DocSchemaFieldFactory();
+    for (const [key, field] of Object.entries(schema)) {
+      const normalizedField = factory.fromUnknown(key, field);
+      normalized[key] = normalizedField.toJson();
+    }
+    return normalized;
+  }
+};
+
+// lib/values/doc-front-matter-md-value.ts
+var DocFrontMatterMdValue = class _DocFrontMatterMdValue {
+  zodSchema;
+  constructor(value, zodSchema) {
+    this.value = zodSchema.parse(value);
+    this.zodSchema = zodSchema;
+    Object.freeze(this.value);
+    Object.freeze(this);
+  }
+  value;
+  toJson() {
+    return this.value;
+  }
+  toYaml() {
+    return stringify2(this.value).trim();
+  }
+  schema(zodSchema) {
+    return new DocSchemaValue(this.value.schema, zodSchema);
+  }
+  /**
+   * Markdownテキストから生成
+   */
+  static from(markdownText, zodSchema) {
+    const openMarkdown = new DocContentMdValue(markdownText);
+    const rawData = openMarkdown.frontMatter.data || {};
+    return new _DocFrontMatterMdValue(rawData, zodSchema);
+  }
+  /**
+   * 空のFrontMatterを生成
+   */
+  static empty(zodSchema) {
+    return new _DocFrontMatterMdValue({}, zodSchema);
+  }
+  /**
+   * データから直接生成
+   */
+  static fromData(data, zodSchema) {
+    return new _DocFrontMatterMdValue(data, zodSchema);
+  }
+  /**
+   * スキーマフィールドに基づいてデフォルト値を生成する
+   */
+  static generateDefaultValueFromSchemaField(fieldDef) {
+    if (fieldDef.type === "text") {
+      return fieldDef.default ?? "";
+    }
+    if (fieldDef.type === "boolean") {
+      return fieldDef.default ?? false;
+    }
+    if (fieldDef.type === "number") {
+      return fieldDef.default ?? 0;
+    }
+    if (fieldDef.type === "multi-text" || fieldDef.type === "multi-number" || fieldDef.type === "multi-boolean" || fieldDef.type === "multi-relation") {
+      return fieldDef.default ?? [];
+    }
+    if (fieldDef.type === "relation") {
+      return fieldDef.default ?? null;
+    }
+    return null;
   }
   /**
-   * フィールド値の検証
+   * 単一のプロパティを更新した新しいインスタンスを返す
    */
-  validateFieldValue(key, value, fieldDef) {
+  withProperty(key, value) {
+    const currentData = {
+      ...this.toJson(),
+      [key]: value
+    };
     try {
-      const factory = new DocSchemaFieldFactory();
-      const schemaField = factory.fromSchemaEntry(key, fieldDef);
-      return schemaField.validate(value);
+      const validated = this.zodSchema.parse(currentData);
+      return new _DocFrontMatterMdValue(validated, this.zodSchema);
     } catch {
-      return false;
+      return this;
     }
   }
   /**
@@ -1615,7 +2012,7 @@ var DocFrontMatterMdValue = class _DocFrontMatterMdValue {
    * プロパティが存在するかチェック
    */
   has(key) {
-    return key in this.value && this.value[key] !== void 0;
+    return key in this.value && this.value[key] !== void 0 && this.value[key] !== null;
   }
   /**
    * すべてのキーを取得
@@ -1623,15 +2020,35 @@ var DocFrontMatterMdValue = class _DocFrontMatterMdValue {
   get keys() {
     return Object.keys(this.value);
   }
-};
-
+  field(key) {
+    try {
+      const parsed = this.zodSchema.parse(this.value);
+      return parsed[key] ?? null;
+    } catch {
+      return this.value[key] ?? null;
+    }
+  }
+  /**
+   * 型安全な値の取得
+   */
+  get typedValue() {
+    try {
+      return this.zodSchema.parse(this.value);
+    } catch {
+      return null;
+    }
+  }
+};
+
 // lib/values/doc-file-content-md-value.ts
 var DocFileContentMdValue = class _DocFileContentMdValue {
-  constructor(value) {
+  constructor(value, zodSchema) {
     this.value = value;
     zDocFileContentMd.parse(value);
+    this.zodSchema = zodSchema;
     Object.freeze(this);
   }
+  zodSchema;
   /**
    * コンテンツ本文（frontMatterを含まない）
    */
@@ -1651,10 +2068,14 @@ var DocFileContentMdValue = class _DocFileContentMdValue {
     return this.value.description;
   }
   /**
-   * FrontMatter
+   * FrontMatter（コンストラクタのZodスキーマまたは引数のスキーマを使用）
    */
-  get frontMatter() {
-    return new DocFrontMatterMdValue(this.value.frontMatter);
+  frontMatter(zodSchema) {
+    const schema = zodSchema || this.zodSchema;
+    return new DocFrontMatterMdValue(
+      this.value.frontMatter,
+      schema
+    );
   }
   /**
    * タイトルを更新
@@ -1664,13 +2085,16 @@ var DocFileContentMdValue = class _DocFileContentMdValue {
     const engine = new DocMarkdownSystem();
     const updatedText = engine.updateTitle(fullText, title);
     const updatedBody = engine.extractBody(updatedText);
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: updatedBody,
-      title,
-      description: this.description,
-      frontMatter: this.value.frontMatter
-    });
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: updatedBody,
+        title,
+        description: this.description,
+        frontMatter: this.value.frontMatter
+      },
+      this.zodSchema
+    );
   }
   /**
    * 説明を更新
@@ -1684,52 +2108,72 @@ var DocFileContentMdValue = class _DocFileContentMdValue {
       defaultTitle || this.title
     );
     const updatedBody = engine.extractBody(updatedText);
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: updatedBody,
-      title: this.title,
-      description,
-      frontMatter: this.value.frontMatter
-    });
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: updatedBody,
+        title: this.title,
+        description,
+        frontMatter: this.value.frontMatter
+      },
+      this.zodSchema
+    );
   }
   /**
    * コンテンツを更新
    */
   withContent(content) {
     const engine = new DocMarkdownSystem();
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: content,
-      title: engine.extractTitle(content) || "",
-      description: engine.extractDescription(content) || "",
-      frontMatter: this.value.frontMatter
-    });
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: content,
+        title: engine.extractTitle(content) || "",
+        description: engine.extractDescription(content) || "",
+        frontMatter: this.value.frontMatter
+      },
+      this.zodSchema
+    );
   }
   /**
    * FrontMatterを更新
    */
-  withFrontMatter(frontMatter) {
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: this.body,
-      title: this.title,
-      description: this.description,
-      frontMatter: frontMatter.value
-    });
+  withFrontMatter(frontMatter, zodSchema) {
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: this.body,
+        title: this.title,
+        description: this.description,
+        frontMatter: frontMatter.value
+      },
+      zodSchema
+    );
+  }
+  /**
+   * FrontMatterの特定のプロパティを更新
+   */
+  withFrontMatterProperty(key, value) {
+    const currentFrontMatter = this.frontMatter();
+    const updatedFrontMatter = currentFrontMatter.withProperty(key, value);
+    return this.withFrontMatter(updatedFrontMatter, this.zodSchema);
   }
   /**
    * Markdownテキストから生成
    */
-  static fromMarkdown(markdown) {
+  static fromMarkdown(markdown, zodSchema = zDocFileMdFrontMatter) {
     const engine = new DocMarkdownSystem();
-    const frontMatter = DocFrontMatterMdValue.from(markdown);
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: engine.extractBody(markdown),
-      title: engine.extractTitle(markdown) || "",
-      description: engine.extractDescription(markdown) || "",
-      frontMatter: frontMatter.value
-    });
+    const frontMatter = DocFrontMatterMdValue.from(markdown, zodSchema);
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: engine.extractBody(markdown),
+        title: engine.extractTitle(markdown) || "",
+        description: engine.extractDescription(markdown) || "",
+        frontMatter: frontMatter.value
+      },
+      zodSchema
+    );
   }
   /**
    * 完全なMarkdownテキストを生成
@@ -1742,7 +2186,7 @@ var DocFileContentMdValue = class _DocFileContentMdValue {
    */
   toText() {
     return `---
-${this.frontMatter.toYaml()}
+${this.frontMatter().toYaml()}
 ---
 
 ${this.body}`;
@@ -1750,14 +2194,17 @@ ${this.body}`;
   /**
    * 空のコンテンツを生成
    */
-  static empty(title) {
-    return new _DocFileContentMdValue({
-      type: "markdown-content",
-      body: `# ${title}`,
-      title,
-      description: "",
-      frontMatter: {}
-    });
+  static empty(title, zodSchema) {
+    return new _DocFileContentMdValue(
+      {
+        type: "markdown-content",
+        body: `# ${title}`,
+        title,
+        description: "",
+        frontMatter: {}
+      },
+      zodSchema
+    );
   }
   /**
    * JSON形式で出力
@@ -1778,7 +2225,7 @@ var DocFileMdEntity = class _DocFileMdEntity {
    * コンテンツ
    */
   get content() {
-    return new DocFileContentMdValue(this.value.content);
+    return new DocFileContentMdValue(this.value.content, zDocFileMdFrontMatter);
   }
   /**
    * パス情報
@@ -1952,424 +2399,160 @@ var DocRelationValue = class _DocRelationValue {
     Object.freeze(this);
     Object.freeze(this.value);
   }
-  /**
-   * リレーションパス
-   */
-  get path() {
-    return this.value.path;
-  }
-  /**
-   * リレーション対象ファイル一覧（値オブジェクト）
-   */
-  get files() {
-    return this.value.files.map((file) => new DocRelationFileValue(file));
-  }
-  /**
-   * ファイル数を取得
-   */
-  get fileCount() {
-    return this.files.length;
-  }
-  /**
-   * 空かどうか
-   */
-  get isEmpty() {
-    return this.files.length === 0;
-  }
-  /**
-   * 空のリレーションエンティティを作成
-   */
-  static empty(path) {
-    return new _DocRelationValue({
-      path,
-      files: []
-    });
-  }
-  /**
-   * JSON形式で出力
-   */
-  toJson() {
-    return {
-      path: this.path,
-      files: this.files.map((file) => file.toJson())
-    };
-  }
-};
-
-// lib/doc-file-relation-reference.ts
-var DocFileRelationReference = class {
-  constructor(props) {
-    this.props = props;
-    this.pathSystem = props.pathSystem;
-    Object.freeze(this);
-  }
-  pathSystem;
-  get fileSystem() {
-    return this.props.fileSystem;
-  }
-  get basePath() {
-    return this.fileSystem.getBasePath();
-  }
-  /**
-   * リレーションパス
-   */
-  get path() {
-    return this.props.filePath;
-  }
-  /**
-   * フルパス
-   */
-  get fullPath() {
-    return this.pathSystem.join(
-      this.fileSystem.getBasePath(),
-      this.props.filePath
-    );
-  }
-  async read() {
-    const files = await this.readFiles();
-    return new DocRelationValue({
-      path: this.path,
-      files: files.map((value) => value.toJson())
-    });
-  }
-  /**
-   * リレーションファイルの一覧を読み込む
-   */
-  async readFiles() {
-    const exists = await this.fileSystem.exists(this.path);
-    if (!exists) {
-      return [];
-    }
-    const filePaths = await this.fileSystem.readDirectoryFilePaths(this.path);
-    const files = [];
-    for (const filePath of filePaths) {
-      const file = await this.readFile(filePath);
-      if (file === null) continue;
-      files.push(file);
-    }
-    return files;
-  }
-  /**
-   * 単一のリレーションファイルを読み込む
-   */
-  async readFile(filePath) {
-    if (filePath.includes("index.md")) {
-      return null;
-    }
-    const content = await this.fileSystem.readFile(filePath);
-    if (content === null) {
-      return null;
-    }
-    const contentValue = DocFileContentMdValue.fromMarkdown(content);
-    const pathValue = DocFilePathValue.fromPathWithSystem(
-      filePath,
-      this.pathSystem,
-      this.basePath
-    );
-    const fileEntity = new DocFileMdEntity({
-      type: "markdown",
-      content: contentValue.value,
-      path: pathValue.value,
-      isArchived: false
-    });
-    return DocRelationFileValue.from(filePath, fileEntity.value.content.title);
-  }
-  /**
-   * ファイルの存在確認
-   */
-  async exists(slug) {
-    const filePath = `${this.path}/${slug}.md`;
-    return this.fileSystem.exists(filePath);
-  }
-  /**
-   * ファイル名の一覧を取得（拡張子なし）
-   */
-  async readSlugs() {
-    const files = await this.readFiles();
-    return files.map((file) => file.id);
-  }
-  /**
-   * ファイル数を取得
-   */
-  async count() {
-    const files = await this.readFiles();
-    return files.length;
-  }
-  /**
-   * 空かどうかを確認
-   */
-  async isEmpty() {
-    const count = await this.count();
-    return count === 0;
-  }
-};
-
-// lib/values/doc-front-matter-index-value.ts
-import { parse as parse2, stringify as stringify3 } from "yaml";
-
-// lib/values/doc-schema-value.ts
-var DocSchemaValue = class _DocSchemaValue {
-  value;
-  constructor(value) {
-    this.value = _DocSchemaValue.normalizeSchema(value);
-    zDocSchema.parse(this.value);
-    Object.freeze(this.value);
-    Object.freeze(this);
-  }
-  /**
-   * フィールド名の一覧を取得
-   */
-  get fieldNames() {
-    return Object.keys(this.value);
-  }
-  /**
-   * 指定されたフィールド名のフィールドを取得
-   */
-  field(name) {
-    const fieldDef = this.value[name];
-    if (fieldDef === void 0) {
-      return null;
-    }
-    const factory = new DocSchemaFieldFactory();
-    return factory.fromUnknown(name, fieldDef);
-  }
-  get fields() {
-    const factory = new DocSchemaFieldFactory();
-    return this.fieldNames.map((name) => {
-      const fieldValue = this.value[name];
-      if (!fieldValue) {
-        throw new Error(`Field ${name} not found in schema`);
-      }
-      return factory.fromUnknown(name, fieldValue);
-    });
-  }
-  get relationFields() {
-    return this.fields.filter((t) => {
-      return t instanceof DocSchemaFieldRelationSingleValue || t instanceof DocSchemaFieldRelationMultipleValue;
-    });
-  }
-  /**
-   * 空のスキーマエンティティを作成
-   */
-  static empty() {
-    return new _DocSchemaValue({});
-  }
-  /**
-   * スキーマからリレーションパスを抽出
-   */
-  extractRelationPaths() {
-    if (!this.value) return /* @__PURE__ */ new Set();
-    const uniqueRelationPaths = /* @__PURE__ */ new Set();
-    for (const field of Object.values(this.value)) {
-      if (this.isRelationField(field) && "path" in field) {
-        uniqueRelationPaths.add(field.path);
-      }
-    }
-    return uniqueRelationPaths;
-  }
-  /**
-   * フィールドがリレーション型かどうかを判定
-   */
-  isRelationField(field) {
-    return field.type === "relation" || field.type === "multi-relation";
-  }
-  /**
-   * リレーションオプションを作成
-   */
-  createRelationOption(filePath, title) {
-    const fileName = this.extractFileName(filePath);
-    return zDocRelationFile.parse({
-      name: fileName,
-      label: title || fileName,
-      value: fileName,
-      path: filePath
-    });
-  }
-  /**
-   * ファイルをスキップすべきかどうかを判定
-   */
-  shouldSkipFile(filePath) {
-    return filePath.endsWith("index.md") || filePath.endsWith("README.md");
-  }
-  /**
-   * 値を指定された型に変換する（デフォルト値フォールバック付き）
-   */
-  convertValue(value, targetType, defaultValue) {
-    if (this.isNullOrUndefined(value)) {
-      return defaultValue;
-    }
-    try {
-      return this.convertByType(value, targetType, defaultValue);
-    } catch {
-      return defaultValue;
-    }
-  }
-  /**
-   * 型別の変換処理
-   */
-  convertByType(value, targetType, defaultValue) {
-    if (targetType === "text") {
-      return this.convertToString(value, defaultValue);
-    }
-    if (targetType === "number") {
-      return this.convertToNumber(value, defaultValue);
-    }
-    if (targetType === "boolean") {
-      return this.convertToBoolean(value, defaultValue);
-    }
-    if (targetType === "multi-text" || targetType === "array") {
-      return this.convertToArray(value, defaultValue);
-    }
-    if (targetType === "relation") {
-      return this.convertToRelation(value, defaultValue);
-    }
-    if (targetType === "multi-relation") {
-      return this.convertToMultiRelation(value, defaultValue);
-    }
-    return defaultValue;
-  }
-  /**
-   * 文字列型への変換
-   */
-  convertToString(value, defaultValue) {
-    if (typeof value === "string") return value;
-    if (typeof value === "number") return String(value);
-    if (typeof value === "boolean") return String(value);
-    return defaultValue;
+  /**
+   * リレーションパス
+   */
+  get path() {
+    return this.value.path;
   }
   /**
-   * 数値型への変換
+   * リレーション対象ファイル一覧（値オブジェクト）
    */
-  convertToNumber(value, defaultValue) {
-    if (typeof value === "number") return value;
-    if (typeof value === "string") {
-      const parsed = Number(value);
-      return Number.isNaN(parsed) ? defaultValue : parsed;
-    }
-    if (typeof value === "boolean") return value ? 1 : 0;
-    return defaultValue;
+  get files() {
+    return this.value.files.map((file) => new DocRelationFileValue(file));
   }
   /**
-   * ブール型への変換
+   * ファイル数を取得
    */
-  convertToBoolean(value, defaultValue) {
-    if (typeof value === "boolean") return value;
-    if (typeof value === "string") {
-      const lower = value.toLowerCase();
-      if (lower === "true" || lower === "1") return true;
-      if (lower === "false" || lower === "0") return false;
-      return defaultValue;
-    }
-    if (typeof value === "number") return value !== 0;
-    return defaultValue;
+  get fileCount() {
+    return this.files.length;
   }
   /**
-   * 配列型への変換
+   * 空かどうか
    */
-  convertToArray(value, defaultValue) {
-    if (Array.isArray(value)) return value;
-    if (typeof value === "string") {
-      return value.split(",").map((item) => item.trim());
-    }
-    return defaultValue;
+  get isEmpty() {
+    return this.files.length === 0;
   }
   /**
-   * リレーション型への変換
+   * 空のリレーションエンティティを作成
    */
-  convertToRelation(value, defaultValue) {
-    if (typeof value === "string") {
-      return this.extractFileNameFromPath(value);
-    }
-    return defaultValue;
+  static empty(path) {
+    return new _DocRelationValue({
+      path,
+      files: []
+    });
   }
   /**
-   * マルチリレーション型への変換
+   * JSON形式で出力
    */
-  convertToMultiRelation(value, defaultValue) {
-    if (Array.isArray(value)) {
-      return value.filter((item) => typeof item === "string").map((item) => this.extractFileNameFromPath(item));
-    }
-    if (typeof value === "string") {
-      return value.split(",").map((item) => this.extractFileNameFromPath(item.trim()));
-    }
-    return defaultValue;
+  toJson() {
+    return {
+      path: this.path,
+      files: this.files.map((file) => file.toJson())
+    };
+  }
+};
+
+// lib/doc-file-relation-reference.ts
+var DocFileRelationReference = class {
+  constructor(props) {
+    this.props = props;
+    this.pathSystem = props.pathSystem;
+    Object.freeze(this);
+  }
+  pathSystem;
+  get fileSystem() {
+    return this.props.fileSystem;
+  }
+  get basePath() {
+    return this.fileSystem.getBasePath();
   }
   /**
-   * パスからファイル名を抽出（拡張子除去）
+   * リレーションパス
    */
-  extractFileNameFromPath(path) {
-    const fileName = path.split("/").pop() || path;
-    return fileName.replace(/\.md$/, "");
+  get path() {
+    return this.props.filePath;
   }
   /**
-   * スキーマベースでFrontMatterを補完する
+   * フルパス
    */
-  getCompleteFrontMatter(rawFrontMatter) {
-    const defaultFrontMatter = this.generateDefaultFrontMatter();
-    return this.mergePreservingExistingValues(
-      defaultFrontMatter,
-      rawFrontMatter
+  get fullPath() {
+    return this.pathSystem.join(
+      this.fileSystem.getBasePath(),
+      this.props.filePath
     );
   }
+  async read() {
+    const files = await this.readFiles();
+    return new DocRelationValue({
+      path: this.path,
+      files: files.map((value) => value.toJson())
+    });
+  }
   /**
-   * スキーマからデフォルトFrontMatterを生成
+   * リレーションファイルの一覧を読み込む
    */
-  generateDefaultFrontMatter() {
-    if (!this.value) return {};
-    const defaultFrontMatter = {};
-    for (const [key, field] of Object.entries(this.value)) {
-      defaultFrontMatter[key] = DocFrontMatterMdValue.generateDefaultValueFromSchemaField(field);
+  async readFiles() {
+    const exists = await this.fileSystem.exists(this.path);
+    if (!exists) {
+      return [];
     }
-    return zDocFileMdFrontMatter.parse(defaultFrontMatter);
+    const filePaths = await this.fileSystem.readDirectoryFilePaths(this.path);
+    const files = [];
+    for (const filePath of filePaths) {
+      const file = await this.readFile(filePath);
+      if (file === null) continue;
+      files.push(file);
+    }
+    return files;
   }
   /**
-   * 既存の値を保持しながらマージ
+   * 単一のリレーションファイルを読み込む
    */
-  mergePreservingExistingValues(defaults, existing) {
-    const result = { ...defaults };
-    if (existing && typeof existing === "object") {
-      const validatedData = zDocFileMdFrontMatter.parse(existing);
-      for (const [key, value] of Object.entries(validatedData)) {
-        if (value !== void 0 && value !== null) {
-          result[key] = value;
-        }
-      }
+  async readFile(filePath) {
+    if (filePath.includes("index.md")) {
+      return null;
     }
-    return result;
+    const content = await this.fileSystem.readFile(filePath);
+    if (content === null) {
+      return null;
+    }
+    const contentValue = DocFileContentMdValue.fromMarkdown(content);
+    const pathValue = DocFilePathValue.fromPathWithSystem(
+      filePath,
+      this.pathSystem,
+      this.basePath
+    );
+    const fileEntity = new DocFileMdEntity({
+      type: "markdown",
+      content: contentValue.value,
+      path: pathValue.value,
+      isArchived: false
+    });
+    return DocRelationFileValue.from(filePath, fileEntity.value.content.title);
   }
   /**
-   * ファイルパスからファイル名を抽出（拡張子なし）
+   * ファイルの存在確認
    */
-  extractFileName(filePath) {
-    return filePath.split("/").pop()?.replace(".md", "") || filePath;
+  async exists(slug) {
+    const filePath = `${this.path}/${slug}.md`;
+    return this.fileSystem.exists(filePath);
   }
   /**
-   * nullまundefinedのチェック
+   * ファイル名の一覧を取得（拡張子なし）
    */
-  isNullOrUndefined(value) {
-    return value === null || value === void 0;
+  async readSlugs() {
+    const files = await this.readFiles();
+    return files.map((file) => file.id);
   }
-  toJson() {
-    return this.value;
+  /**
+   * ファイル数を取得
+   */
+  async count() {
+    const files = await this.readFiles();
+    return files.length;
   }
   /**
-   * スキーマを正規化
+   * 空かどうかを確認
    */
-  static normalizeSchema(schema) {
-    const normalized = {};
-    const factory = new DocSchemaFieldFactory();
-    for (const [key, field] of Object.entries(schema)) {
-      try {
-        const normalizedField = factory.fromUnknown(key, field);
-        normalized[key] = normalizedField.toJson();
-      } catch {
-      }
-    }
-    return normalized;
+  async isEmpty() {
+    const count = await this.count();
+    return count === 0;
   }
 };
 
 // lib/values/doc-front-matter-index-value.ts
+import { parse as parse2, stringify as stringify3 } from "yaml";
 var DocFrontMatterIndexValue = class _DocFrontMatterIndexValue {
   constructor(value) {
     this.value = value;
@@ -2379,14 +2562,14 @@ var DocFrontMatterIndexValue = class _DocFrontMatterIndexValue {
   /**
    * アイコンを取得
    */
-  get icon() {
+  icon() {
     return this.value.icon;
   }
   /**
    * スキーマを取得
    */
-  get schema() {
-    return new DocSchemaValue(this.value.schema);
+  schema(zodSchema) {
+    return new DocSchemaValue(this.value.schema, zodSchema);
   }
   /**
    * iconフィールドを更新
@@ -2760,7 +2943,8 @@ var DocFileIndexReference = class _DocFileIndexReference {
   async read() {
     const content = await this.fileSystem.readFile(this.filePath);
     if (content === null) {
-      const dirName = this.filePath.split("/").pop() || "directory";
+      const dirPath = this.pathSystem.dirname(this.filePath);
+      const dirName = this.pathSystem.basename(dirPath);
       const pathValue2 = DocFilePathValue.fromPathWithSystem(
         this.filePath,
         this.pathSystem,
@@ -3139,12 +3323,16 @@ var DocFileMdReference = class _DocFileMdReference {
     if (file instanceof Error) {
       return file;
     }
-    const relationValue = file.content.frontMatter.relation(key);
+    const relationValue = file.content.frontMatter().relation(key);
     if (relationValue === null) {
       return null;
     }
-    const indexFile = await this.getDirectoryIndex();
-    if (!indexFile) {
+    const indexRef = await this.getDirectoryIndex();
+    if (!indexRef) {
+      return null;
+    }
+    const indexFile = await indexRef.read();
+    if (indexFile instanceof Error) {
       return null;
     }
     const schemaData = indexFile.content.frontMatter.value.schema;
@@ -3156,7 +3344,12 @@ var DocFileMdReference = class _DocFileMdReference {
     if (!field || !("path" in field) || !field.path) {
       return null;
     }
-    const fullPath = this.pathSystem.join(field.path, `${relationValue}.md`);
+    let resolvedPath = field.path;
+    if (field.path.startsWith("..")) {
+      resolvedPath = this.pathSystem.join(this.directoryPath, field.path);
+      resolvedPath = this.pathSystem.normalize(resolvedPath);
+    }
+    const fullPath = this.pathSystem.join(resolvedPath, `${relationValue}.md`);
     return new _DocFileMdReference({
       path: fullPath,
       fileSystem: this.fileSystem,
@@ -3168,16 +3361,28 @@ var DocFileMdReference = class _DocFileMdReference {
    */
   async getDirectoryIndex() {
     const indexPath = this.pathSystem.join(this.directoryPath, "index.md");
-    const indexRef = new _DocFileMdReference({
-      path: indexPath,
-      fileSystem: this.fileSystem,
-      pathSystem: this.pathSystem
-    });
-    const indexFile = await indexRef.read();
-    if (indexFile instanceof Error) {
-      return null;
+    const exists = await this.fileSystem.exists(indexPath);
+    if (exists) {
+      return new DocFileIndexReference({
+        path: indexPath,
+        fileSystem: this.fileSystem,
+        pathSystem: this.pathSystem
+      });
+    }
+    const archivedIndexPath = this.pathSystem.join(
+      this.directoryPath,
+      "_",
+      "index.md"
+    );
+    const archivedExists = await this.fileSystem.exists(archivedIndexPath);
+    if (archivedExists) {
+      return new DocFileIndexReference({
+        path: archivedIndexPath,
+        fileSystem: this.fileSystem,
+        pathSystem: this.pathSystem
+      });
     }
-    return indexFile;
+    return null;
   }
   /**
    * 複数のリレーションを取得する
@@ -3193,12 +3398,16 @@ var DocFileMdReference = class _DocFileMdReference {
     if (file instanceof Error) {
       return [];
     }
-    const relationValues = file.content.frontMatter.multiRelation(key);
+    const relationValues = file.content.frontMatter().multiRelation(key);
     if (relationValues.length === 0) {
       return [];
     }
-    const indexFile = await this.getDirectoryIndex();
-    if (!indexFile) {
+    const indexRef = await this.getDirectoryIndex();
+    if (!indexRef) {
+      return [];
+    }
+    const indexFile = await indexRef.read();
+    if (indexFile instanceof Error) {
       return [];
     }
     const schemaData = indexFile.content.frontMatter.value.schema;
@@ -3211,7 +3420,12 @@ var DocFileMdReference = class _DocFileMdReference {
       return [];
     }
     return relationValues.map((relationValue) => {
-      const fullPath = this.pathSystem.join(field.path, `${relationValue}.md`);
+      let resolvedPath = field.path;
+      if (field.path.startsWith("..")) {
+        resolvedPath = this.pathSystem.join(this.directoryPath, field.path);
+        resolvedPath = this.pathSystem.normalize(resolvedPath);
+      }
+      const fullPath = this.pathSystem.join(resolvedPath, `${relationValue}.md`);
       return new _DocFileMdReference({
         path: fullPath,
         fileSystem: this.fileSystem,
@@ -3219,6 +3433,38 @@ var DocFileMdReference = class _DocFileMdReference {
       });
     });
   }
+  /**
+   * FrontMatterを型安全に読み込む
+   */
+  async readFrontMatter(zodSchema) {
+    const entity = await this.read();
+    if (entity instanceof Error) {
+      return entity;
+    }
+    return entity.content.frontMatter(zodSchema);
+  }
+  /**
+   * FrontMatterを型安全に更新
+   */
+  async updateFrontMatter(key, value, zodSchema) {
+    const entity = await this.read();
+    if (entity instanceof Error) {
+      return entity;
+    }
+    const currentFrontMatter = entity.content.frontMatter(zodSchema);
+    const updatedFrontMatter = currentFrontMatter.withProperty(key, value);
+    const baseContent = new DocFileContentMdValue(
+      entity.content.value,
+      zDocFileMdFrontMatter
+    );
+    const updatedContent = baseContent.withFrontMatter(
+      updatedFrontMatter,
+      zDocFileMdFrontMatter
+    );
+    const updatedEntity = entity.withContent(updatedContent);
+    await this.write(updatedEntity);
+    return void 0;
+  }
 };
 
 // lib/entities/doc-file-unknown-entity.ts
@@ -3562,6 +3808,17 @@ var DocDirectoryReference = class _DocDirectoryReference {
     }
     return files;
   }
+  /**
+   * Markdownファイルの参照とFrontMatterを型安全に取得
+   */
+  async mdFilesWithFrontMatter(zodSchema) {
+    const results = [];
+    for await (const file of this.mdFilesGenerator()) {
+      const frontMatter = await file.readFrontMatter(zodSchema);
+      results.push({ reference: file, frontMatter });
+    }
+    return results;
+  }
   file(fileName) {
     const filePath = this.pathSystem.join(this.relativePath, fileName);
     if (fileName.endsWith(".md")) {
@@ -3603,6 +3860,21 @@ var DocDirectoryReference = class _DocDirectoryReference {
     }
     return entities;
   }
+  /**
+   * Zodスキーマを使って型安全にMarkdownファイルのFrontMatterを読み込む
+   */
+  async readMdFilesWithSchema(zodSchema) {
+    const results = [];
+    for await (const file of this.mdFilesGenerator()) {
+      const entity = await file.read();
+      if (entity instanceof Error) continue;
+      const frontMatter = entity.content.frontMatter(
+        zodSchema
+      );
+      results.push({ entity, frontMatter });
+    }
+    return results;
+  }
   async readUnknownFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
@@ -3914,7 +4186,12 @@ var DocFileTreeSystem = class {
     if (await indexFile.exists()) {
       const entity = await indexFile.read();
       title = entity.value.content.title || fileName;
-      icon = entity.value.content.frontMatter.icon || "\u{1F4C1}";
+      const content = entity.content;
+      const frontMatter = content.frontMatter;
+      if (frontMatter instanceof DocFrontMatterIndexValue) {
+        const iconValue = frontMatter.icon();
+        icon = iconValue || "\u{1F4C1}";
+      }
     }
     const children = await this.buildFileTree(filePath);
     return DocTreeDirectoryNodeValue.from({
@@ -3975,7 +4252,12 @@ var DocFileTreeSystem = class {
     if (await indexFile.exists()) {
       const entity = await indexFile.read();
       title = entity.value.content.title || fileName;
-      icon = entity.value.content.frontMatter.icon || "\u{1F4C1}";
+      const content = entity.content;
+      const frontMatter = content.frontMatter;
+      if (frontMatter instanceof DocFrontMatterIndexValue) {
+        const iconValue = frontMatter.icon();
+        icon = iconValue || "\u{1F4C1}";
+      }
     }
     const children = await this.buildDirectoryTree(filePath);
     return DocTreeDirectoryNodeValue.from({
@@ -4615,6 +4897,7 @@ export {
   zDocSchema,
   zDocSchemaField,
   zDocSchemaFieldBoolean,
+  zDocSchemaFieldMinimal,
   zDocSchemaFieldMultiBoolean,
   zDocSchemaFieldMultiNumber,
   zDocSchemaFieldMultiRelation,
@@ -4627,6 +4910,7 @@ export {
   zDocSchemaFieldSelectText,
   zDocSchemaFieldText,
   zDocSchemaFieldType,
+  zDocSchemaMinimal,
   zDocTreeDirectoryNode,
   zDocTreeFileNode,
   zDocTreeNode