@shuji-bonji/pdf-writer-mcp 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.7.0] - 2026-07-17
+
+コードレビュー（2026-07-17）と TASKS.md E 系（コード衛生・family 整合）への
+一括対応。**ツール名・必須フィールド・成功時の出力形式は不変**。エラー応答の
+形式のみ family 契約に揃えて変わった（minor バンプの理由）。
+
+### Changed
+
+- **McpServer + Zod へ移行（E-5）** — 低レベル `Server` + 手書き JSON Schema
+  （definitions.ts 553 行）+ asserts 検査（validation.ts 502 行）の二重管理を解消。
+  Zod スキーマ（validation.ts）が公開スキーマと実行時検証の単一情報源になった。
+  reader / verify と同じ `registerTool` パターン。`server.ts` の `buildServer()`
+  はテストから `InMemoryTransport` で検証され、`registry.test.ts` が 17 ツールの
+  名前・必須フィールド・annotations を外部仕様スナップショットとして固定する。
+- **構造化エラー（E-2）** — `{error: message}` から reader v0.6.0 と同じ
+  `code` / `hint` / `next_actions` / `retryable` 形式へ。writer 固有のガードは
+  すべて「解除フラグ付きで再試行可能」として表現される:
+  `SIGNED_PDF` (allowBreakingSignatures) / `TAGGED_PDF` (allowBreakingTags) /
+  `FONT_REQUIRED` (fontPath) / `MISSING_GLYPH` (onMissingGlyph)。ほかに
+  `DOC_NOT_FOUND` / `FILE_TOO_LARGE` / `ENCRYPTED_PDF` / `INVALID_PDF` /
+  `UNSUPPORTED_PDF_FEATURE` (XFA) / `FONT_NOT_FOUND` / `INVALID_ARGUMENT`。
+- **ページ操作を page-ops.ts へ分離** — merge / split / extract / delete /
+  reorder / rotate を editor.ts（20.6kB → 16.1kB）から切り出し。mergePdfs が
+  文書情報の引き継ぎのために先頭ファイルを二重読込していた無駄も解消。
+
+### Added
+
+- **パス検査の強化（E-1）** — すべてのパス引数（inputPath / inputPaths[] /
+  outputPath / outputDir / fontPath / attachmentPath）に絶対パスを強制し、
+  `..` セグメントを拒否。入力 PDF に 100MB のサイズ上限を新設
+  （verify の `MAX_FILE_SIZE` と同水準）。
+- **stdout ガード（E-3）** — `marked` / `subset-font` 等の依存が `console.log`
+  を吐いても stdio の JSON-RPC を汚染しないよう、side-effect-first の
+  `stdout-guard.ts` を導入（reader / verify と同パターン）。
+- **tool annotations（E-4）** — 全 17 ツールに `readOnlyHint` /
+  `destructiveHint` / `idempotentHint` / `openWorldHint` を付与。
+  `destructiveHint: true` は情報が失われる `delete_pages` と `flatten_form` のみ。
+- **決定論的出力（E-6）** — 環境変数 `SOURCE_DATE_EPOCH`（UNIX 秒、
+  reproducible-builds.org の慣習）設定時に CreationDate / ModificationDate /
+  XMP の日時を固定し、同一入力 → 同一バイト列を保証。学習データ工場の
+  差分検証・キャッシュ・再現テスト用。不正値は黙殺せずエラー。
+- 依存に `zod ^4.4.3` を追加。
+
 ## [0.6.0] - 2026-07-16
 
 ### Added

package/dist/config.d.ts

@@ -15,7 +15,19 @@ export declare const PACKAGE_INFO: {
 export declare const ENV_KEYS: {
     /** デフォルトで埋め込むフォントファイルのパス（.ttf / .otf） */
     readonly DEFAULT_FONT: 'PDF_WRITER_FONT';
+    /**
+     * 決定論的出力（E-6）: reproducible-builds.org の慣習に従う UNIX 秒。
+     * 設定時は CreationDate / ModificationDate / XMP の各日時に固定値を使い、
+     * 同一入力 → 同一バイト列を保証する（学習データ工場の差分検証・キャッシュ用）。
+     */
+    readonly SOURCE_DATE_EPOCH: 'SOURCE_DATE_EPOCH';
 };
+/**
+ * 出力に焼き込む「現在時刻」。SOURCE_DATE_EPOCH が設定されていれば固定値を返す。
+ * 値が不正（数値でない・負）な場合は黙って現在時刻に落とさずエラーにする —
+ * 再現性を期待した呼び出し側が黙って非決定的な出力を得るのが最悪のケースのため。
+ */
+export declare function outputDate(): Date;
 /**
  * PDF 生成のデフォルト値
  * 単位はすべて pt（1pt = 1/72 inch）

package/dist/config.js

@@ -18,7 +18,28 @@ export const PACKAGE_INFO = {
 export const ENV_KEYS = {
     /** デフォルトで埋め込むフォントファイルのパス（.ttf / .otf） */
     DEFAULT_FONT: 'PDF_WRITER_FONT',
+    /**
+     * 決定論的出力（E-6）: reproducible-builds.org の慣習に従う UNIX 秒。
+     * 設定時は CreationDate / ModificationDate / XMP の各日時に固定値を使い、
+     * 同一入力 → 同一バイト列を保証する（学習データ工場の差分検証・キャッシュ用）。
+     */
+    SOURCE_DATE_EPOCH: 'SOURCE_DATE_EPOCH',
 };
+/**
+ * 出力に焼き込む「現在時刻」。SOURCE_DATE_EPOCH が設定されていれば固定値を返す。
+ * 値が不正（数値でない・負）な場合は黙って現在時刻に落とさずエラーにする —
+ * 再現性を期待した呼び出し側が黙って非決定的な出力を得るのが最悪のケースのため。
+ */
+export function outputDate() {
+    const raw = process.env[ENV_KEYS.SOURCE_DATE_EPOCH];
+    if (raw === undefined || raw === '')
+        return new Date();
+    const epoch = Number(raw);
+    if (!Number.isFinite(epoch) || epoch < 0) {
+        throw new Error(`${ENV_KEYS.SOURCE_DATE_EPOCH} must be a non-negative number of seconds, got "${raw}"`);
+    }
+    return new Date(epoch * 1000);
+}
 /**
  * PDF 生成のデフォルト値
  * 単位はすべて pt（1pt = 1/72 inch）

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAG5C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,yCAAyC;IACzC,YAAY,EAAE,iBAAiB;CACvB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,QAAQ,EAAE,IAAI;IACd,eAAe;IACf,MAAM,EAAE,EAAE,EAAE,SAAS;IACrB,gBAAgB;IAChB,QAAQ,EAAE,EAAE;IACZ,wDAAwD;IACxD,UAAU,EAAE,IAAI;IAChB,eAAe;IACf,YAAY,EAAE,CAAC;CACP,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAG5C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,yCAAyC;IACzC,YAAY,EAAE,iBAAiB;IAC/B;;;;OAIG;IACH,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACpD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,CAAC,iBAAiB,mDAAmD,GAAG,GAAG,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;IACd,QAAQ,EAAE,IAAI;IACd,eAAe;IACf,MAAM,EAAE,EAAE,EAAE,SAAS;IACrB,gBAAgB;IAChB,QAAQ,EAAE,EAAE;IACZ,wDAAwD;IACxD,UAAU,EAAE,IAAI;IAChB,eAAe;IACf,YAAY,EAAE,CAAC;CACP,CAAC"}

package/dist/constants.d.ts

@@ -38,6 +38,11 @@ export declare const LIMITS: {
     readonly BOOKMARK_MAX_DEPTH: 8;
     /** 埋め込みファイルの最大サイズ（バイト）。PDF 全体がメモリに載るため上限を設ける */
     readonly ATTACHMENT_MAX_BYTES: number;
+    /**
+     * 入力 PDF の最大サイズ（バイト）。pdf-lib は全体をメモリに載せるため、
+     * verify（MAX_FILE_SIZE = 100MB）と同水準の上限を設ける。
+     */
+    readonly INPUT_PDF_MAX_BYTES: number;
 };
 /** stamp_page_numbers の配置 */
 export declare const STAMP_POSITIONS: readonly ['bottom-left', 'bottom-center', 'bottom-right', 'top-left', 'top-center', 'top-right'];

package/dist/constants.js

@@ -37,6 +37,11 @@ export const LIMITS = {
     BOOKMARK_MAX_DEPTH: 8,
     /** 埋め込みファイルの最大サイズ（バイト）。PDF 全体がメモリに載るため上限を設ける */
     ATTACHMENT_MAX_BYTES: 100 * 1024 * 1024,
+    /**
+     * 入力 PDF の最大サイズ（バイト）。pdf-lib は全体をメモリに載せるため、
+     * verify（MAX_FILE_SIZE = 100MB）と同水準の上限を設ける。
+     */
+    INPUT_PDF_MAX_BYTES: 100 * 1024 * 1024,
 };
 /** stamp_page_numbers の配置 */
 export const STAMP_POSITIONS = [

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;CACV,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,qBAAqB;IACrB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,EAAE;IACjB,sCAAsC;IACtC,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,GAAG;IACf,6CAA6C;IAC7C,eAAe,EAAE,OAAO;IACxB,+BAA+B;IAC/B,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE,KAAK;IACrB,4BAA4B;IAC5B,gBAAgB,EAAE,EAAE;IACpB,wBAAwB;IACxB,eAAe,EAAE,GAAG;IACpB,uBAAuB;IACvB,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,CAAC;IACrB,gDAAgD;IAChD,oBAAoB,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;CAC/B,CAAC;AAEX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa;IACb,eAAe;IACf,cAAc;IACd,UAAU;IACV,YAAY;IACZ,WAAW;CACH,CAAC;AAEX,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,CAAC;CACF,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,IAAI;CACJ,CAAC;AAEX,sDAAsD;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,MAAM;IACN,aAAa;IACb,YAAY;IACZ,aAAa;CACL,CAAC;AAEX,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAEzE,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,SAAS;IACT,KAAK;IACL,MAAM;IACN,cAAc;IACd,WAAW;IACX,QAAQ;CACA,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,GAAG,EAAE,MAAM;CACH,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;CACV,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,qBAAqB;IACrB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,EAAE;IACjB,sCAAsC;IACtC,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,GAAG;IACf,6CAA6C;IAC7C,eAAe,EAAE,OAAO;IACxB,+BAA+B;IAC/B,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE,KAAK;IACrB,4BAA4B;IAC5B,gBAAgB,EAAE,EAAE;IACpB,wBAAwB;IACxB,eAAe,EAAE,GAAG;IACpB,uBAAuB;IACvB,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,CAAC;IACrB,gDAAgD;IAChD,oBAAoB,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IACvC;;;OAGG;IACH,mBAAmB,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;CAC9B,CAAC;AAEX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa;IACb,eAAe;IACf,cAAc;IACd,UAAU;IACV,YAAY;IACZ,WAAW;CACH,CAAC;AAEX,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,CAAC;CACF,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,IAAI;CACJ,CAAC;AAEX,sDAAsD;AACtD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,MAAM;IACN,aAAa;IACb,YAAY;IACZ,aAAa;CACL,CAAC;AAEX,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAEzE,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,SAAS;IACT,KAAK;IACL,MAAM;IACN,cAAc;IACd,WAAW;IACX,QAAQ;CACA,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,GAAG,EAAE,MAAM;CACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * family-compatible 構造化エラー応答（E-2） — pdf-writer-mcp 実装
+ *
+ * 設計指針:
+ * - pdf-reader-mcp v0.6.0 の error contract に準拠（`code` 文字列を共有）
+ * - 共通パッケージ依存を持たない独立実装
+ * - writer 固有のコード（SIGNED_PDF / TAGGED_PDF / FONT_REQUIRED /
+ *   MISSING_GLYPH）を追加。いずれも「明示フラグや引数の追加で再試行できる」
+ *   ガード系で、`retryable: true` + `next_actions` により出力パイプライン
+ *   Skill / LLM エージェントが自律的に分岐できる。
+ *
+ * family contract 仕様:
+ * @see https://github.com/shuji-bonji/houki-research-skill/blob/main/docs/ERROR-CODES.md
+ */
+/** family 共通コードの部分集合 + writer 固有拡張 */
+export type WriterErrorCode = 'INVALID_ARGUMENT' | 'DOC_NOT_FOUND' | 'FONT_NOT_FOUND' | 'INVALID_PDF' | 'ENCRYPTED_PDF' | 'UNSUPPORTED_PDF_FEATURE' | 'FILE_TOO_LARGE' | 'SIGNED_PDF' | 'TAGGED_PDF' | 'FONT_REQUIRED' | 'MISSING_GLYPH' | 'INTERNAL_ERROR';
+/** 次に取るべきアクションの提案。LLM が読んで自律的に再試行することを想定 */
+export interface NextAction {
+    /** 推奨アクション（tool 名 or 自然言語） */
+    action: string;
+    /** どんなときに有効か */
+    reason: string;
+    /** 具体的な引数例（任意） */
+    example?: Record<string, unknown>;
+}
+/** family-compatible 共通エラー応答 */
+export interface WriterServiceError {
+    /** 1文の人間可読メッセージ（LLM もここを読む） */
+    error: string;
+    /** プログラム判定用の安定したコード */
+    code: WriterErrorCode;
+    /** 追加情報（任意） */
+    hint?: string;
+    /** LLM が次に取るべき手段の候補 */
+    next_actions?: NextAction[];
+    /** フラグや引数を変えれば再試行できるか */
+    retryable?: boolean;
+}
+/** コード・ヒント・next_actions を運ぶ writer 固有の Error */
+export declare class PdfWriterError extends Error {
+    readonly code: WriterErrorCode;
+    readonly options: {
+        hint?: string;
+        next_actions?: NextAction[];
+        retryable?: boolean;
+    };
+    constructor(message: string, code: WriterErrorCode, options?: {
+        hint?: string;
+        next_actions?: NextAction[];
+        retryable?: boolean;
+    });
+}
+/** 引数エラーの短縮形（validation.ts / page-spec.ts の大量の検査で使う） */
+export declare function invalidArg(message: string): PdfWriterError;
+/** 投げられた値を family 形式のエラー応答へ変換する */
+export declare function toStructuredError(error: unknown): WriterServiceError;
+/** よく使う next_actions のプリセット（writer のガード解除フラグ群） */
+export declare const NEXT_ACTIONS: {
+    readonly allowBreakingSignatures: () => NextAction;
+    readonly allowBreakingTags: () => NextAction;
+    readonly provideFontPath: () => NextAction;
+    readonly changeMissingGlyphPolicy: () => NextAction;
+    readonly checkFilePath: (path?: string) => NextAction;
+};

package/dist/errors.js

@@ -0,0 +1,76 @@
+/**
+ * family-compatible 構造化エラー応答（E-2） — pdf-writer-mcp 実装
+ *
+ * 設計指針:
+ * - pdf-reader-mcp v0.6.0 の error contract に準拠（`code` 文字列を共有）
+ * - 共通パッケージ依存を持たない独立実装
+ * - writer 固有のコード（SIGNED_PDF / TAGGED_PDF / FONT_REQUIRED /
+ *   MISSING_GLYPH）を追加。いずれも「明示フラグや引数の追加で再試行できる」
+ *   ガード系で、`retryable: true` + `next_actions` により出力パイプライン
+ *   Skill / LLM エージェントが自律的に分岐できる。
+ *
+ * family contract 仕様:
+ * @see https://github.com/shuji-bonji/houki-research-skill/blob/main/docs/ERROR-CODES.md
+ */
+/** コード・ヒント・next_actions を運ぶ writer 固有の Error */
+export class PdfWriterError extends Error {
+    code;
+    options;
+    constructor(message, code, options = {}) {
+        super(message);
+        this.code = code;
+        this.options = options;
+        this.name = 'PdfWriterError';
+    }
+}
+/** 引数エラーの短縮形（validation.ts / page-spec.ts の大量の検査で使う） */
+export function invalidArg(message) {
+    return new PdfWriterError(message, 'INVALID_ARGUMENT');
+}
+/** 投げられた値を family 形式のエラー応答へ変換する */
+export function toStructuredError(error) {
+    if (error instanceof PdfWriterError) {
+        const out = { error: error.message, code: error.code };
+        if (error.options.hint)
+            out.hint = error.options.hint;
+        if (error.options.next_actions && error.options.next_actions.length > 0) {
+            out.next_actions = error.options.next_actions;
+        }
+        if (error.options.retryable !== undefined)
+            out.retryable = error.options.retryable;
+        return out;
+    }
+    if (error instanceof Error) {
+        return { error: error.message, code: 'INTERNAL_ERROR' };
+    }
+    return { error: String(error), code: 'INTERNAL_ERROR' };
+}
+/** よく使う next_actions のプリセット（writer のガード解除フラグ群） */
+export const NEXT_ACTIONS = {
+    allowBreakingSignatures: () => ({
+        action: 'retry_with_allowBreakingSignatures',
+        reason: '署名を無効化してよい場合のみ、同じ引数に "allowBreakingSignatures": true を足して再試行してください',
+        example: { allowBreakingSignatures: true },
+    }),
+    allowBreakingTags: () => ({
+        action: 'retry_with_allowBreakingTags',
+        reason: 'PDF/UA 適合を壊してよい場合のみ、"allowBreakingTags": true を足して再試行してください',
+        example: { allowBreakingTags: true },
+    }),
+    provideFontPath: () => ({
+        action: 'retry_with_fontPath',
+        reason: '非 Latin 文字（日本語等）には埋め込みフォントが必要です。"fontPath" に .ttf/.otf を指定するか、環境変数 PDF_WRITER_FONT を設定してください',
+        example: { fontPath: '/path/to/NotoSansJP-Regular.otf' },
+    }),
+    changeMissingGlyphPolicy: () => ({
+        action: 'retry_with_onMissingGlyph',
+        reason: 'フォントに無い文字が本文に含まれます。別のフォントを指定するか、"onMissingGlyph": "replace"（豆腐で置換）/ "ignore"（黙って除去）を指定してください',
+        example: { onMissingGlyph: 'replace' },
+    }),
+    checkFilePath: (path) => ({
+        action: 'verify_file_path',
+        reason: 'ファイルパスが正しいか、絶対パスで指定されているか確認してください',
+        example: path ? { inputPath: path } : undefined,
+    }),
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8CH,gDAAgD;AAChD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB,IAAI;IACJ,OAAO;IAHzB,YACE,OAAe,EACC,IAAqB,EACrB,OAAO,GAInB,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;oBAPC,IAAI;uBACJ,OAAO;QAOvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AACzD,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,MAAM,GAAG,GAAuB,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAChD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACnF,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AAC1D,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,uBAAuB,EAAE,GAAe,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,oCAAoC;QAC5C,MAAM,EACJ,oEAAoE;QACtE,OAAO,EAAE,EAAE,uBAAuB,EAAE,IAAI,EAAE;KAC3C,CAAC;IACF,iBAAiB,EAAE,GAAe,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,8BAA8B;QACtC,MAAM,EAAE,6DAA6D;QACrE,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE;KACrC,CAAC;IACF,eAAe,EAAE,GAAe,EAAE,CAAC,CAAC;QAClC,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EACJ,8FAA8F;QAChG,OAAO,EAAE,EAAE,QAAQ,EAAE,iCAAiC,EAAE;KACzD,CAAC;IACF,wBAAwB,EAAE,GAAe,EAAE,CAAC,CAAC;QAC3C,MAAM,EAAE,2BAA2B;QACnC,MAAM,EACJ,8FAA8F;QAChG,OAAO,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE;KACvC,CAAC;IACF,aAAa,EAAE,CAAC,IAAa,EAAc,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,mCAAmC;QAC3C,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KAChD,CAAC;CACM,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 /**
  * pdf-writer-mcp — MCP server entry
- * テキスト / Markdown / 表データから PDF を生成する。
+ * テキスト / Markdown / 表データから PDF を生成し、既存 PDF を編集する。
+ *
+ * E-5: reader / verify と同じ McpServer + registerTool + Zod 構成。
+ * ツール定義（説明・スキーマ・annotations）は tools/definitions.ts の
+ * レジストリ、実装は tools/handlers.ts、スキーマは utils/validation.ts。
  */
-export {};
+import './utils/stdout-guard.js';

package/dist/index.js

@@ -1,46 +1,20 @@
 #!/usr/bin/env node
 /**
  * pdf-writer-mcp — MCP server entry
- * テキスト / Markdown / 表データから PDF を生成する。
+ * テキスト / Markdown / 表データから PDF を生成し、既存 PDF を編集する。
+ *
+ * E-5: reader / verify と同じ McpServer + registerTool + Zod 構成。
+ * ツール定義（説明・スキーマ・annotations）は tools/definitions.ts の
+ * レジストリ、実装は tools/handlers.ts、スキーマは utils/validation.ts。
  */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+// stdout ガードは他のあらゆる import より先（side-effect first）
+import './utils/stdout-guard.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { PACKAGE_INFO } from './config.js';
-import { tools } from './tools/definitions.js';
-import { toolHandlers } from './tools/handlers.js';
+import { buildServer } from './server.js';
 import { logger } from './utils/logger.js';
-const server = new Server({
-    name: PACKAGE_INFO.name,
-    version: PACKAGE_INFO.version,
-}, {
-    capabilities: { tools: {} },
-});
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools,
-}));
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-        const handler = toolHandlers[name];
-        if (!handler) {
-            throw new Error(`Unknown tool: ${name}`);
-        }
-        const result = await handler(args);
-        return {
-            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.error(name, message, error instanceof Error ? error : undefined);
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ error: message }, null, 2) }],
-            isError: true,
-        };
-    }
-});
 async function main() {
+    const server = buildServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     logger.info(PACKAGE_INFO.name, `v${PACKAGE_INFO.version} started (stdio)`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,OAAO,EAAE,YAAY,CAAC,OAAO;CAC9B,EACD;IACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CAC5B,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK;CACN,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,wBAAwB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,kDAAkD;AAClD,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,wBAAwB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * McpServer の構築（E-5）。
+ * index.ts（stdio 接続）とテスト（InMemoryTransport）の両方から使う。
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function buildServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,45 @@
+/**
+ * McpServer の構築（E-5）。
+ * index.ts（stdio 接続）とテスト（InMemoryTransport）の両方から使う。
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { PACKAGE_INFO } from './config.js';
+import { toStructuredError } from './errors.js';
+import { tools } from './tools/definitions.js';
+import { toolHandlers } from './tools/handlers.js';
+import { logger } from './utils/logger.js';
+export function buildServer() {
+    const server = new McpServer({
+        name: PACKAGE_INFO.name,
+        version: PACKAGE_INFO.version,
+    });
+    for (const tool of tools) {
+        const handler = toolHandlers[tool.name];
+        if (!handler) {
+            throw new Error(`No handler registered for tool: ${tool.name}`);
+        }
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.shape,
+            annotations: tool.annotations,
+        }, async (args) => {
+            try {
+                const result = await handler(args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                const structured = toStructuredError(error);
+                logger.error(tool.name, structured.error, error instanceof Error ? error : undefined);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,OAAO,EAAE,YAAY,CAAC,OAAO;KAC9B,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAa,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBAC5E,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACtF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC/E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/builder.js

@@ -9,6 +9,7 @@
 import { PDFDocument, rgb } from 'pdf-lib';
 import { DEFAULTS } from '../config.js';
 import { PAGE_SIZES, RENDERER_GENERATED_CHARS } from '../constants.js';
+import { invalidArg } from '../errors.js';
 import { inferLang } from '../utils/lang.js';
 import { applyMissingGlyphPolicy, embedFontFor, openFont, } from './font-manager.js';
 import { LayoutEngine } from './layout.js';
@@ -43,7 +44,7 @@ export async function buildPdf(opts, inputTexts, render) {
     let lang;
     if (opts.tagged) {
         if (!title) {
-            throw new Error('tagged: true requires "title" — PDF/UA (ISO 14289-1, 7.1) mandates a document title.');
+            throw invalidArg('tagged: true requires "title" — PDF/UA (ISO 14289-1, 7.1) mandates a document title.');
         }
         lang = opts.lang;
         if (!lang) {

package/dist/services/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/services/builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/services/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAqB,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,uBAAuB,EACvB,YAAY,EAEZ,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAQ7C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAyB,EACzB,UAAoB,EACpB,MAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE7C,qCAAqC;IACrC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,KAAK;QAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAErD,8BAA8B;IAC9B,0CAA0C;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACxE,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAElE,0BAA0B;IAC1B,2CAA2C;IAC3C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAE7F,MAAM,QAAQ,GAAiB,IAAI,CAAC,QAAQ,IAAK,QAAQ,CAAC,QAAyB,CAAC;IACpF,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAEpD,kBAAkB;IAClB,IAAI,MAAqC,CAAC;IAC1C,IAAI,IAAwB,CAAC;IAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,CACd,sFAAsF,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YACrB,QAAQ,CAAC,IAAI,CACX,QAAQ,CAAC,SAAS;gBAChB,CAAC,CAAC,kCAAkC,IAAI,wCAAwC;gBAChF,CAAC,CAAC,kCAAkC,IAAI,6IAA6I,CACxL,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE;QACnC,SAAS;QACT,UAAU;QACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM;QACtC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ;QACR,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,MAAM;KACP,CAAC,CAAC;IAEH,sDAAsD;IACtD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE;YAC1B,IAAI,EAAE,QAAQ,GAAG,CAAC;YAClB,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnB,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE9B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClB,iBAAiB,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAc,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/editor.d.ts

@@ -1,6 +1,9 @@
 /**
  * Editor
- * 既存 PDF の編集（Tier A: メタデータ・ページ操作）を担う。
+ * 既存 PDF の編集の共通基盤（loadForEdit / saveEdited）と、ページ操作以外の
+ * 編集ツール（メタデータ・しおり・注釈・添付・スタンプ・透かし・フォーム）。
+ * ページ単位の操作（merge / split / extract / delete / reorder / rotate）は
+ * page-ops.ts に分離した。
  *
  * create 系（builder → font → layout → renderer）とはフローが異なり、
  *   読込（loadForEdit: 署名ガード込み）→ 操作 → 保存（saveEdited）
@@ -12,15 +15,16 @@
  *   allowBreakingSignatures: true があるときのみ続行する。
  *   署名を保持する増分更新（incremental_save）は Tier C の課題。
  */
-import type { AddAnnotationArgs, AddBookmarksArgs, AddWatermarkArgs, AttachFileArgs, AttachResult, CommonEditOptions, EditResult, FillFormArgs, FlattenFormArgs, FormResult, SetMetadataArgs, SplitResult, StampPageNumbersArgs, StampResult, WatermarkResult } from '../types/index.js';
+import { PDFDocument } from 'pdf-lib';
+import type { AddAnnotationArgs, AddBookmarksArgs, AddWatermarkArgs, AttachFileArgs, AttachResult, CommonEditOptions, EditResult, FillFormArgs, FlattenFormArgs, FormResult, SetMetadataArgs, StampPageNumbersArgs, StampResult, WatermarkResult } from '../types/index.js';
 /** 入力バイト列に電子署名（/ByteRange）が含まれるかの軽量検査 */
 export declare function containsSignature(bytes: Uint8Array): boolean;
+/** PDF を読み込み、署名ガード・サイズ上限を通す（page-ops.ts と共用） */
+export declare function loadForEdit(filePath: string, opts: CommonEditOptions): Promise<{
+    doc: PDFDocument;
+    absPath: string;
+}>;
 export declare function setMetadata(args: SetMetadataArgs): Promise<EditResult>;
-export declare function mergePdfs(inputPaths: string[], opts: CommonEditOptions): Promise<EditResult>;
-export declare function extractPages(inputPath: string, pages: string, opts: CommonEditOptions): Promise<EditResult>;
-export declare function deletePages(inputPath: string, pages: string, opts: CommonEditOptions): Promise<EditResult>;
-export declare function reorderPages(inputPath: string, order: number[], opts: CommonEditOptions): Promise<EditResult>;
-export declare function rotatePages(inputPath: string, rotation: number, pages: string | undefined, opts: CommonEditOptions): Promise<EditResult>;
 export declare function addBookmarks(args: AddBookmarksArgs): Promise<EditResult>;
 export declare function addAnnotation(args: AddAnnotationArgs): Promise<EditResult>;
 export declare function attachFileToPdf(args: AttachFileArgs): Promise<AttachResult>;
@@ -28,4 +32,3 @@ export declare function stampPageNumbers(args: StampPageNumbersArgs): Promise<St
 export declare function addWatermark(args: AddWatermarkArgs): Promise<WatermarkResult>;
 export declare function fillForm(args: FillFormArgs): Promise<FormResult>;
 export declare function flattenForm(args: FlattenFormArgs): Promise<FormResult>;
-export declare function splitPdf(inputPath: string, ranges: string[], outputDir: string, prefix: string | undefined, opts: CommonEditOptions): Promise<SplitResult>;