backlog-exporter 1.0.0 → 1.1.0

package/README.md

@@ -49,7 +49,7 @@ $ npm install -g backlog-exporter
 $ backlog-exporter COMMAND
 running command...
 $ backlog-exporter (--version)
-backlog-exporter/1.0.0 linux-x64 node-v26.4.0
+backlog-exporter/1.1.0 linux-x64 node-v26.5.0
 $ backlog-exporter --help [COMMAND]
 USAGE
   $ backlog-exporter COMMAND
@@ -159,8 +159,30 @@ $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KE
 $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --issueKeyFileName --issueKeyFolder
 ```
 
+**課題の添付ファイルもダウンロードする**
+
+```sh
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --downloadAttachments
+```
+
 エクスポートされた課題は、指定したディレクトリ内に Markdown ファイルとして保存されます。ファイル名は課題のキーに基づいて自動的に生成されます。
 
+## 添付ファイルのダウンロード
+
+`--downloadAttachments`（短縮形: `-d`）フラグを指定すると、課題・Wiki・ドキュメントの添付ファイルもダウンロードされます（`all` / `issue` / `wiki` / `document` / `update` コマンドで使用可能）。
+
+- 保存先:
+  - 課題: デフォルトは `{年}/attachments/{課題キー}/`、`--issueKeyFolder` 指定時は課題フォルダ直下の `attachments/`
+  - Wiki: Markdownと同じディレクトリの `attachments/{Wiki名}/`（階層Wikiは末尾のページ名）
+  - ドキュメント: Markdownと同じディレクトリの `attachments/{ドキュメント名}/`
+- ファイル名は同名の衝突を避けるため `{添付ID}_{ファイル名}` になります
+- Markdown の `## 添付ファイル` セクションにローカルファイルへの相対リンクが記載されます（フラグ未指定時はファイル名とサイズのみ記載）
+- 課題の本文・コメント内の添付画像のインライン記法（`![image][ファイル名]` / `#image(ファイル名)`）は、ダウンロード済みファイルへの画像リンクに変換され、Markdownビューアでそのまま表示できます
+- Wiki・ドキュメントの本文はBacklogの原文のまま維持されます（添付参照記法の書き換えは行いません）。添付ファイルへは `## 添付ファイル` セクションのリンクからアクセスできます
+- ダウンロード済みのファイルは再ダウンロードされないため、`update` コマンドでの差分更新でも効率的に動作します
+- 設定は `backlog-settings.json` に保存され、以降の `update` コマンドで自動的に引き継がれます（`update` コマンド自体でフラグを指定した場合はその実行のみ有効です）
+- Backlog側で削除された添付ファイルは、誤削除防止のため `prune` コマンドでも削除されず残ります
+
 ## カスタム属性の対応
 
 課題のエクスポートでは、Backlogのカスタム属性も含めて出力されます：

package/dist/commands/all/index.d.ts

@@ -5,6 +5,7 @@ export default class All extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        downloadAttachments: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         exclude: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         issueKeyFileName: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         issueKeyFolder: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/all/index.js

@@ -44,6 +44,11 @@ export default class All extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        downloadAttachments: Flags.boolean({
+            char: 'd',
+            description: '課題の添付ファイルもダウンロードする',
+            required: false,
+        }),
         exclude: Flags.string({
             description: "Exclude the specified types, separated by commas (e.g., 'documents,wiki')",
             required: false,
@@ -79,7 +84,7 @@ export default class All extends Command {
     async run() {
         const { flags } = await this.parse(All);
         try {
-            const { domain, exclude, issueKeyFileName, issueKeyFolder, maxCount, only, projectIdOrKey } = flags;
+            const { domain, downloadAttachments, exclude, issueKeyFileName, issueKeyFolder, maxCount, only, projectIdOrKey } = flags;
             const apiKey = resolveApiKey(flags.apiKey, () => this.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します')) ??
                 this.error(API_KEY_NOT_FOUND_MESSAGE);
             const outputRoot = flags.output || './backlog-data';
@@ -93,11 +98,12 @@ export default class All extends Command {
             const repositories = createBacklogRepositories({
                 apiKey,
                 domain,
-                onRateLimitWait: () => this.log('レート制限を回避するため15秒間待機します...'),
+                onRateLimitExceeded: (waitSeconds) => this.log(`レート制限の上限に達しました。${waitSeconds}秒待機します...`),
             });
             await exportAll({ ...repositories, logger }, {
                 apiKey,
                 domain,
+                downloadAttachments,
                 issueKeyFileName,
                 issueKeyFolder,
                 maxCount,

package/dist/commands/document/index.d.ts

@@ -5,6 +5,7 @@ export default class Document extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        downloadAttachments: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         keyword: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         projectIdOrKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/document/index.js

@@ -29,6 +29,11 @@ export default class Document extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        downloadAttachments: Flags.boolean({
+            char: 'd',
+            description: '添付ファイルもダウンロードする',
+            required: false,
+        }),
         keyword: Flags.string({
             description: '検索キーワード',
             required: false,
@@ -46,7 +51,7 @@ export default class Document extends Command {
     async run() {
         const { flags } = await this.parse(Document);
         try {
-            const { domain, keyword, projectIdOrKey } = flags;
+            const { domain, downloadAttachments, keyword, projectIdOrKey } = flags;
             const apiKey = resolveApiKey(flags.apiKey, () => this.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します')) ??
                 this.error(API_KEY_NOT_FOUND_MESSAGE);
             const outputDir = flags.output || './backlog-documents';
@@ -54,7 +59,7 @@ export default class Document extends Command {
             const { documentRepository, projectRepository } = createBacklogRepositories({
                 apiKey,
                 domain,
-                onRateLimitWait: () => this.log('レート制限を回避するため15秒間待機します...'),
+                onRateLimitExceeded: (waitSeconds) => this.log(`レート制限の上限に達しました。${waitSeconds}秒待機します...`),
             });
             // 出力ディレクトリの作成
             await ensureDirectory(outputDir);
@@ -65,6 +70,7 @@ export default class Document extends Command {
             await updateSettings(outputDir, {
                 apiKey,
                 domain,
+                downloadAttachments,
                 folderType: FolderType.DOCUMENT,
                 outputDir,
                 projectIdOrKey,
@@ -72,6 +78,7 @@ export default class Document extends Command {
             // ドキュメントの取得と保存
             await exportDocuments({ documentRepository, logger }, {
                 domain,
+                downloadAttachments,
                 keyword,
                 outputDir,
                 projectId,

package/dist/commands/issue/index.d.ts

@@ -5,6 +5,7 @@ export default class Issue extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        downloadAttachments: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         issueKeyFileName: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         issueKeyFolder: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         maxCount: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/issue/index.js

@@ -30,6 +30,9 @@ export default class Issue extends Command {
 `,
         `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --issueKeyFileName --issueKeyFolder
 課題キーでフォルダを作成し、ファイル名も課題キーにする
+`,
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --downloadAttachments
+課題の添付ファイルもダウンロードする
 `,
     ];
     static flags = {
@@ -41,6 +44,11 @@ export default class Issue extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        downloadAttachments: Flags.boolean({
+            char: 'd',
+            description: '課題の添付ファイルもダウンロードする',
+            required: false,
+        }),
         issueKeyFileName: Flags.boolean({
             description: 'ファイル名を課題キーにする',
             required: false,
@@ -72,7 +80,7 @@ export default class Issue extends Command {
     async run() {
         const { flags } = await this.parse(Issue);
         try {
-            const { domain, issueKeyFileName, issueKeyFolder, maxCount, projectIdOrKey, statusId } = flags;
+            const { domain, downloadAttachments, issueKeyFileName, issueKeyFolder, maxCount, projectIdOrKey, statusId } = flags;
             const apiKey = resolveApiKey(flags.apiKey, () => this.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します')) ??
                 this.error(API_KEY_NOT_FOUND_MESSAGE);
             const outputDir = flags.output || './backlog-issues';
@@ -80,7 +88,7 @@ export default class Issue extends Command {
             const { issueRepository, projectRepository } = createBacklogRepositories({
                 apiKey,
                 domain,
-                onRateLimitWait: () => this.log('レート制限を回避するため15秒間待機します...'),
+                onRateLimitExceeded: (waitSeconds) => this.log(`レート制限の上限に達しました。${waitSeconds}秒待機します...`),
             });
             // 出力ディレクトリの作成
             await ensureDirectory(outputDir);
@@ -91,6 +99,7 @@ export default class Issue extends Command {
             await updateSettings(outputDir, {
                 apiKey,
                 domain,
+                downloadAttachments,
                 folderType: FolderType.ISSUE,
                 issueKeyFileName,
                 issueKeyFolder,
@@ -101,6 +110,7 @@ export default class Issue extends Command {
             await exportIssues({ issueRepository, logger }, {
                 count: maxCount,
                 domain,
+                downloadAttachments,
                 issueKeyFileName,
                 issueKeyFolder,
                 outputDir,

package/dist/commands/update/index.d.ts

@@ -10,6 +10,7 @@ export default class Update extends Command {
         documentId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         documentsOnly: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        downloadAttachments: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         issueIdOrKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         issueKeyFileName: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/update/index.js

@@ -62,6 +62,11 @@ export default class Update extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: false,
         }),
+        downloadAttachments: Flags.boolean({
+            char: 'd',
+            description: '課題の添付ファイルもダウンロードする（未指定時は設定ファイルの値を使用）',
+            required: false,
+        }),
         force: Flags.boolean({
             char: 'f',
             description: '確認プロンプトをスキップする',

package/dist/commands/wiki/index.d.ts

@@ -5,6 +5,7 @@ export default class Wiki extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        downloadAttachments: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         projectIdOrKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/wiki/index.js

@@ -26,6 +26,11 @@ Wikiをダウンロードする
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        downloadAttachments: Flags.boolean({
+            char: 'd',
+            description: '添付ファイルもダウンロードする',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             description: '出力ディレクトリパス',
@@ -39,7 +44,7 @@ Wikiをダウンロードする
     async run() {
         const { flags } = await this.parse(Wiki);
         try {
-            const { domain, projectIdOrKey } = flags;
+            const { domain, downloadAttachments, projectIdOrKey } = flags;
             const apiKey = resolveApiKey(flags.apiKey, () => this.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します')) ??
                 this.error(API_KEY_NOT_FOUND_MESSAGE);
             const outputDir = flags.output || './wiki';
@@ -47,7 +52,7 @@ Wikiをダウンロードする
             const { wikiRepository } = createBacklogRepositories({
                 apiKey,
                 domain,
-                onRateLimitWait: () => this.log('レート制限を回避するため15秒間待機します...'),
+                onRateLimitExceeded: (waitSeconds) => this.log(`レート制限の上限に達しました。${waitSeconds}秒待機します...`),
             });
             // 出力ディレクトリの作成
             await ensureDirectory(outputDir);
@@ -55,6 +60,7 @@ Wikiをダウンロードする
             await updateSettings(outputDir, {
                 apiKey,
                 domain,
+                downloadAttachments,
                 folderType: FolderType.WIKI,
                 outputDir,
                 projectIdOrKey,
@@ -62,6 +68,7 @@ Wikiをダウンロードする
             // Wikiの取得と保存
             await exportWikis({ logger, wikiRepository }, {
                 domain,
+                downloadAttachments,
                 outputDir,
                 projectIdOrKey,
             });

package/dist/composition/backlog-repositories.d.ts

@@ -5,7 +5,7 @@ import { WikiRepository } from '../modules/wiki/domain/wiki-repository.js';
 export interface BacklogConnection {
     apiKey: string;
     domain: string;
-    onRateLimitWait?: () => void;
+    onRateLimitExceeded?: (waitSeconds: number) => void;
 }
 export interface BacklogRepositories {
     documentRepository: DocumentRepository;

package/dist/composition/backlog-repositories.js

@@ -3,7 +3,7 @@ import { newBacklogIssueRepository } from '../modules/issue/repository/backlog-i
 import { newBacklogProjectRepository } from '../modules/project/repository/backlog-project-repository.js';
 import { newBacklogWikiRepository } from '../modules/wiki/repository/backlog-wiki-repository.js';
 import { BacklogHttpClient } from '../shared/backlog/http-client.js';
-// 1つのHTTPクライアント（＝レート制限カウンタ）を全repositoryで共有する
+// 1つのHTTPクライアントを全repositoryで共有する
 export function createBacklogRepositories(connection) {
     const client = new BacklogHttpClient(connection);
     return {

package/dist/modules/all/use-case/export-all.d.ts

@@ -14,6 +14,7 @@ export type ExportTarget = 'documents' | 'issues' | 'wiki';
 export interface ExportAllOptions {
     apiKey: string;
     domain: string;
+    downloadAttachments?: boolean;
     issueKeyFileName?: boolean;
     issueKeyFolder?: boolean;
     maxCount: number;

package/dist/modules/all/use-case/export-all.js

@@ -7,7 +7,7 @@ import { updateSettings } from '../../settings/repository/settings-store.js';
 import { exportWikis } from '../../wiki/use-case/export-wikis.js';
 export async function exportAll(deps, options) {
     const { documentRepository, issueRepository, logger, projectRepository, wikiRepository } = deps;
-    const { apiKey, domain, issueKeyFileName, issueKeyFolder, maxCount, outputRoot, projectIdOrKey, targets } = options;
+    const { apiKey, domain, downloadAttachments, issueKeyFileName, issueKeyFolder, maxCount, outputRoot, projectIdOrKey, targets } = options;
     await ensureDirectory(outputRoot);
     const projectId = await projectRepository.resolveProjectId(projectIdOrKey);
     logger.log(`プロジェクトID: ${projectId} を使用します`);
@@ -17,6 +17,7 @@ export async function exportAll(deps, options) {
         await updateSettings(issueOutput, {
             apiKey,
             domain,
+            downloadAttachments,
             folderType: FolderType.ISSUE,
             issueKeyFileName,
             issueKeyFolder,
@@ -27,6 +28,7 @@ export async function exportAll(deps, options) {
         await exportIssues({ issueRepository, logger }, {
             count: maxCount,
             domain,
+            downloadAttachments,
             issueKeyFileName,
             issueKeyFolder,
             outputDir: issueOutput,
@@ -41,6 +43,7 @@ export async function exportAll(deps, options) {
         await updateSettings(wikiOutput, {
             apiKey,
             domain,
+            downloadAttachments,
             folderType: FolderType.WIKI,
             outputDir: wikiOutput,
             projectIdOrKey,
@@ -48,6 +51,7 @@ export async function exportAll(deps, options) {
         logger.log('Wikiの取得を開始します...');
         await exportWikis({ logger, wikiRepository }, {
             domain,
+            downloadAttachments,
             outputDir: wikiOutput,
             projectIdOrKey,
         });
@@ -60,6 +64,7 @@ export async function exportAll(deps, options) {
         await updateSettings(documentOutput, {
             apiKey,
             domain,
+            downloadAttachments,
             folderType: FolderType.DOCUMENT,
             outputDir: documentOutput,
             projectIdOrKey,
@@ -67,6 +72,7 @@ export async function exportAll(deps, options) {
         logger.log('ドキュメントの取得を開始します...');
         await exportDocuments({ documentRepository, logger }, {
             domain,
+            downloadAttachments,
             outputDir: documentOutput,
             projectId,
             projectIdOrKey,

package/dist/modules/document/domain/document-markdown.d.ts

@@ -1,2 +1,2 @@
 import { DocumentDetail } from './document.js';
-export declare function buildDocumentMarkdown(documentDetail: DocumentDetail, backlogDocumentUrl: string): string;
+export declare function buildDocumentMarkdown(documentDetail: DocumentDetail, backlogDocumentUrl: string, attachmentLinks?: Map<number, string>): string;

package/dist/modules/document/domain/document-markdown.js

@@ -1,13 +1,16 @@
+import { escapeLinkText } from '../../../shared/attachment.js';
 import { wrapBody } from '../../../shared/markdown/body-marker.js';
-export function buildDocumentMarkdown(documentDetail, backlogDocumentUrl) {
-    // 添付ファイルリストの作成
+export function buildDocumentMarkdown(documentDetail, backlogDocumentUrl, attachmentLinks) {
+    // 添付ファイルリストの作成（ダウンロード済みはローカルへの相対リンク付き）
     let attachmentsSection = '';
     if (documentDetail.attachments && documentDetail.attachments.length > 0) {
         attachmentsSection = '\n\n## 添付ファイル\n';
         for (const attachment of documentDetail.attachments) {
             const attachmentDate = new Date(attachment.created).toLocaleString('ja-JP');
             const fileSize = (attachment.size / 1024).toFixed(1);
-            attachmentsSection += `- **${attachment.name}** (${fileSize} KB) - 作成者: ${attachment.createdUser.name}, 作成日時: ${attachmentDate}\n`;
+            const link = attachmentLinks?.get(attachment.id);
+            const label = link ? `[${escapeLinkText(attachment.name)}](${link})` : `**${attachment.name}**`;
+            attachmentsSection += `- ${label} (${fileSize} KB) - 作成者: ${attachment.createdUser.name}, 作成日時: ${attachmentDate}\n`;
         }
     }
     // タグリストの作成

package/dist/modules/document/domain/document-path.d.ts

@@ -4,6 +4,14 @@ export declare const PARENT_DOCUMENT_INDEX_FILENAME = "00_index.md";
 export declare function documentFolderPath(currentPath: string, folderName: string): string;
 export declare function documentFileName(title: string, asParentIndex: boolean): string;
 export declare function documentUrl(domain: string, projectIdOrKey: string, documentId: string): string;
+export declare function documentAttachmentRelativePath(currentPath: string, documentTitle: string, attachment: {
+    id: number;
+    name: string;
+}): string;
+export declare function documentAttachmentMarkdownLink(documentTitle: string, attachment: {
+    id: number;
+    name: string;
+}): string;
 export interface DocumentTreePaths extends ExpectedPaths {
     leafNodes: Array<{
         currentPath: string;

package/dist/modules/document/domain/document-path.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import { attachmentFileName, encodeLinkDestination } from '../../../shared/attachment.js';
 import { backlogOrigin } from '../../../shared/backlog-url.js';
 import { sanitizeFileName } from '../../../shared/file-name.js';
 // 子を持つ親ドキュメント自身の本文の保存先。ダウンロード側とprune側でレイアウト定義を共有する
@@ -12,6 +13,14 @@ export function documentFileName(title, asParentIndex) {
 export function documentUrl(domain, projectIdOrKey, documentId) {
     return `${backlogOrigin(domain)}/document/${projectIdOrKey}/${documentId}`;
 }
+// 添付の保存先はMarkdownと同じディレクトリの attachments/{ドキュメント名}/ 配下。
+// タイトル改名時は再ダウンロードになるが、Markdown本体（{タイトル}.md）と同じ挙動で閲覧性を優先する
+export function documentAttachmentRelativePath(currentPath, documentTitle, attachment) {
+    return path.join(currentPath, 'attachments', sanitizeFileName(documentTitle), attachmentFileName(attachment));
+}
+export function documentAttachmentMarkdownLink(documentTitle, attachment) {
+    return encodeLinkDestination(['.', 'attachments', sanitizeFileName(documentTitle), attachmentFileName(attachment)].join('/'));
+}
 export function collectDocumentTreePaths(rootNodes) {
     const expectedFiles = new Set();
     const expectedDirs = new Set();

package/dist/modules/document/domain/document-repository.d.ts

@@ -1,5 +1,6 @@
 import { DocumentDetail, DocumentTree } from './document.js';
 export interface DocumentRepository {
+    downloadAttachment(documentId: string, attachmentId: number): Promise<ArrayBuffer>;
     fetchAllTitles(projectId: number): Promise<Map<string, string>>;
     fetchDetail(documentId: string): Promise<DocumentDetail>;
     fetchTree(projectId: number): Promise<DocumentTree>;

package/dist/modules/document/repository/backlog-document-repository.js

@@ -1,5 +1,9 @@
 export function newBacklogDocumentRepository(client) {
     return {
+        // 公式ドキュメント未記載だが公式SDK(nulab/backlog-js)に存在するエンドポイント
+        async downloadAttachment(documentId, attachmentId) {
+            return client.getBinary(`/documents/${documentId}/attachments/${attachmentId}`);
+        },
         async fetchAllTitles(projectId) {
             const titlesById = new Map();
             const pageSize = 100;

package/dist/modules/document/use-case/export-documents.d.ts

@@ -7,6 +7,7 @@ export interface ExportDocumentsDeps {
 export interface ExportDocumentsOptions {
     documentIds?: string[];
     domain: string;
+    downloadAttachments?: boolean;
     keyword?: string;
     lastUpdated?: string;
     outputDir: string;

package/dist/modules/document/use-case/export-documents.js

@@ -1,9 +1,9 @@
 import path from 'node:path';
 import { writeProgress } from '../../../shared/console/progress.js';
-import { deleteFile, ensureDirectory, fileExists, writeMarkdownFile } from '../../../shared/storage/markdown-store.js';
+import { deleteFile, ensureDirectory, fileExists, fileSize, writeBinaryFile, writeMarkdownFile, } from '../../../shared/storage/markdown-store.js';
 import { appendLog } from '../../../shared/storage/update-log.js';
 import { buildDocumentMarkdown } from '../domain/document-markdown.js';
-import { documentFileName, documentFolderPath, documentUrl, PARENT_DOCUMENT_INDEX_FILENAME, } from '../domain/document-path.js';
+import { documentAttachmentMarkdownLink, documentAttachmentRelativePath, documentFileName, documentFolderPath, documentUrl, PARENT_DOCUMENT_INDEX_FILENAME, } from '../domain/document-path.js';
 import { planDocumentSave } from '../domain/document-save-plan.js';
 export async function exportDocuments(deps, options) {
     const { documentRepository, logger } = deps;
@@ -42,7 +42,10 @@ export async function exportDocuments(deps, options) {
                 }
                 case 'save': {
                     const backlogDocumentUrl = documentUrl(options.domain, options.projectIdOrKey, node.id);
-                    await writeMarkdownFile(filePath, buildDocumentMarkdown(documentDetail, backlogDocumentUrl));
+                    const attachmentLinks = options.downloadAttachments
+                        ? await downloadDocumentAttachments(deps, documentDetail, currentPath, options.outputDir)
+                        : undefined;
+                    await writeMarkdownFile(filePath, buildDocumentMarkdown(documentDetail, backlogDocumentUrl, attachmentLinks));
                     writtenFiles.add(filePath);
                     await appendLog(options.outputDir, `ドキュメント「${documentDetail.title}」を更新しました: ${backlogDocumentUrl}`);
                     break;
@@ -80,3 +83,25 @@ export async function exportDocuments(deps, options) {
     logger.log(`\n合計 ${processedDocuments.length}件のドキュメントが処理されました。`);
     logger.log('ドキュメントのダウンロードが完了しました！');
 }
+// 保存できた添付のみリンク化する。個々の失敗は警告に留め、ドキュメント本体の保存は続行する
+async function downloadDocumentAttachments(deps, documentDetail, currentPath, outputDir) {
+    const links = new Map();
+    for (const attachment of documentDetail.attachments ?? []) {
+        const absolutePath = path.join(outputDir, documentAttachmentRelativePath(currentPath, documentDetail.title, attachment));
+        try {
+            // 添付IDは不変のため、サイズの一致するファイルが既にあれば再ダウンロードしない
+            // eslint-disable-next-line no-await-in-loop
+            if ((await fileSize(absolutePath)) !== attachment.size) {
+                // eslint-disable-next-line no-await-in-loop
+                const data = await deps.documentRepository.downloadAttachment(documentDetail.id, attachment.id);
+                // eslint-disable-next-line no-await-in-loop
+                await writeBinaryFile(absolutePath, data);
+            }
+            links.set(attachment.id, documentAttachmentMarkdownLink(documentDetail.title, attachment));
+        }
+        catch (error) {
+            deps.logger.warn(`ドキュメント「${documentDetail.title}」の添付ファイル「${attachment.name}」の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return links;
+}

package/dist/modules/issue/domain/issue-markdown.d.ts

@@ -1,4 +1,5 @@
-import { CustomField, Issue, IssueComment } from './issue.js';
+import { CustomField, Issue, IssueAttachment, IssueComment } from './issue.js';
 export declare function createCustomFieldsSection(customFields?: CustomField[]): string;
-export declare function buildCommentsSection(comments: IssueComment[], backlogIssueUrl: string): string;
-export declare function buildIssueMarkdown(issue: Issue, comments: IssueComment[], backlogIssueUrl: string): string;
+export declare function buildAttachmentsSection(attachments: IssueAttachment[] | undefined, localLinks?: Map<number, string>): string;
+export declare function buildCommentsSection(comments: IssueComment[], backlogIssueUrl: string, rewriteBody?: (text: string) => string): string;
+export declare function buildIssueMarkdown(issue: Issue, comments: IssueComment[], backlogIssueUrl: string, attachmentLinks?: Map<number, string>): string;

package/dist/modules/issue/domain/issue-markdown.js

@@ -1,3 +1,4 @@
+import { escapeLinkText, rewriteInlineImages } from '../../../shared/attachment.js';
 import { wrapBody } from '../../../shared/markdown/body-marker.js';
 // Backlogの変更履歴（changeLog）のfieldを画面表示に合わせた日本語ラベルへ変換する
 const CHANGE_FIELD_LABELS = {
@@ -31,10 +32,10 @@ function formatChange(change) {
     const label = CHANGE_FIELD_LABELS[change.field] ?? change.field;
     return `- ${label}: ${formatChangeValue(change.originalValue)} → ${formatChangeValue(change.newValue)}`;
 }
-function buildCommentBody(comment) {
+function buildCommentBody(comment, rewriteBody) {
     const parts = [];
     if (comment.content) {
-        parts.push(comment.content);
+        parts.push(rewriteBody(comment.content));
     }
     if (comment.changeLog && comment.changeLog.length > 0) {
         parts.push(['**変更内容**', ...comment.changeLog.map((change) => formatChange(change))].join('\n'));
@@ -71,7 +72,19 @@ export function createCustomFieldsSection(customFields) {
     }
     return customFieldsSection;
 }
-export function buildCommentsSection(comments, backlogIssueUrl) {
+// ダウンロード済みの添付はローカルへの相対リンク付き、未ダウンロードはメタデータのみを出力する
+export function buildAttachmentsSection(attachments, localLinks) {
+    if (!attachments || attachments.length === 0) {
+        return '';
+    }
+    const lines = attachments.map((attachment) => {
+        const fileSize = `${(attachment.size / 1024).toFixed(1)} KB`;
+        const link = localLinks?.get(attachment.id);
+        return link ? `- [${escapeLinkText(attachment.name)}](${link}) (${fileSize})` : `- ${attachment.name} (${fileSize})`;
+    });
+    return `\n\n## 添付ファイル\n\n${lines.join('\n')}`;
+}
+export function buildCommentsSection(comments, backlogIssueUrl, rewriteBody = (text) => text) {
     if (comments.length === 0) {
         return '';
     }
@@ -80,15 +93,17 @@ export function buildCommentsSection(comments, backlogIssueUrl) {
     for (const comment of comments) {
         const commentDate = new Date(comment.created).toLocaleString('ja-JP');
         const backlogCommentUrl = `${backlogIssueUrl}#comment-${comment.id}`;
-        commentsSection += `\n### コメント ${commentIndex}\n- **投稿者**: ${comment.createdUser.name}\n- **日時**: ${commentDate}\n- [Backlog Comment Link](${backlogCommentUrl})\n\n${buildCommentBody(comment)}\n\n---\n`;
+        commentsSection += `\n### コメント ${commentIndex}\n- **投稿者**: ${comment.createdUser.name}\n- **日時**: ${commentDate}\n- [Backlog Comment Link](${backlogCommentUrl})\n\n${buildCommentBody(comment, rewriteBody)}\n\n---\n`;
         commentIndex++;
     }
     // 最後の区切り線を削除
     return commentsSection.slice(0, -5);
 }
-export function buildIssueMarkdown(issue, comments, backlogIssueUrl) {
-    const commentsSection = buildCommentsSection(comments, backlogIssueUrl);
+export function buildIssueMarkdown(issue, comments, backlogIssueUrl, attachmentLinks) {
+    const rewriteBody = (text) => rewriteInlineImages(text, issue.attachments, attachmentLinks);
+    const commentsSection = buildCommentsSection(comments, backlogIssueUrl, rewriteBody);
     const customFieldsSection = createCustomFieldsSection(issue.customFields);
+    const attachmentsSection = buildAttachmentsSection(issue.attachments, attachmentLinks);
     const assigneeName = issue.assignee ? issue.assignee.name : '未割り当て';
     const startDate = issue.startDate ? new Date(issue.startDate).toLocaleDateString('ja-JP') : '未設定';
     const dueDate = issue.dueDate ? new Date(issue.dueDate).toLocaleDateString('ja-JP') : '未設定';
@@ -104,9 +119,9 @@ export function buildIssueMarkdown(issue, comments, backlogIssueUrl) {
 - 期限日: ${dueDate}
 - 作成日時: ${new Date(issue.created).toLocaleString('ja-JP')}
 - 更新日時: ${new Date(issue.updated).toLocaleString('ja-JP')}
-- [Backlog Issue Link](${backlogIssueUrl})${customFieldsSection}
+- [Backlog Issue Link](${backlogIssueUrl})${customFieldsSection}${attachmentsSection}
 
 ## 詳細
 
-${wrapBody(issue.description || '詳細情報なし')}${commentsSection}`;
+${wrapBody(issue.description ? rewriteBody(issue.description) : '詳細情報なし')}${commentsSection}`;
 }

package/dist/modules/issue/domain/issue-path.d.ts

@@ -1,5 +1,5 @@
 import { ExpectedPaths } from '../../prune/domain/expected-paths.js';
-import { Issue } from './issue.js';
+import { Issue, IssueAttachment } from './issue.js';
 export declare function issueFileName(issue: {
     issueKey: string;
     summary: string;
@@ -16,6 +16,17 @@ export declare function issueRelativePath(issue: {
     issueKeyFileName?: boolean;
     issueKeyFolder?: boolean;
 }): string;
+export declare function attachmentRelativePath(issue: {
+    created: string;
+    issueKey: string;
+}, attachment: Pick<IssueAttachment, 'id' | 'name'>, options: {
+    issueKeyFolder?: boolean;
+}): string;
+export declare function attachmentMarkdownLink(issue: {
+    issueKey: string;
+}, attachment: Pick<IssueAttachment, 'id' | 'name'>, options: {
+    issueKeyFolder?: boolean;
+}): string;
 export declare function issueUrl(domain: string, issueKey: string): string;
 export declare function buildIssueExpectedPaths(issues: Issue[], options: {
     issueKeyFileName?: boolean;