backlog-exporter 0.7.3 → 1.1.0

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

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { ensureDirectory } from '../../../shared/storage/markdown-store.js';
+import { exportDocuments } from '../../document/use-case/export-documents.js';
+import { exportIssues } from '../../issue/use-case/export-issues.js';
+import { FolderType } from '../../settings/domain/settings.js';
+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, downloadAttachments, issueKeyFileName, issueKeyFolder, maxCount, outputRoot, projectIdOrKey, targets } = options;
+    await ensureDirectory(outputRoot);
+    const projectId = await projectRepository.resolveProjectId(projectIdOrKey);
+    logger.log(`プロジェクトID: ${projectId} を使用します`);
+    if (targets.includes('issues')) {
+        const issueOutput = path.join(outputRoot, 'issues');
+        await ensureDirectory(issueOutput);
+        await updateSettings(issueOutput, {
+            apiKey,
+            domain,
+            downloadAttachments,
+            folderType: FolderType.ISSUE,
+            issueKeyFileName,
+            issueKeyFolder,
+            outputDir: issueOutput,
+            projectIdOrKey,
+        });
+        logger.log('課題の取得を開始します...');
+        await exportIssues({ issueRepository, logger }, {
+            count: maxCount,
+            domain,
+            downloadAttachments,
+            issueKeyFileName,
+            issueKeyFolder,
+            outputDir: issueOutput,
+            projectId,
+        });
+        await updateSettings(issueOutput, { lastUpdated: new Date().toISOString() });
+        logger.log('課題の取得が完了しました');
+    }
+    if (targets.includes('wiki')) {
+        const wikiOutput = path.join(outputRoot, 'wiki');
+        await ensureDirectory(wikiOutput);
+        await updateSettings(wikiOutput, {
+            apiKey,
+            domain,
+            downloadAttachments,
+            folderType: FolderType.WIKI,
+            outputDir: wikiOutput,
+            projectIdOrKey,
+        });
+        logger.log('Wikiの取得を開始します...');
+        await exportWikis({ logger, wikiRepository }, {
+            domain,
+            downloadAttachments,
+            outputDir: wikiOutput,
+            projectIdOrKey,
+        });
+        await updateSettings(wikiOutput, { lastUpdated: new Date().toISOString() });
+        logger.log('Wikiの取得が完了しました');
+    }
+    if (targets.includes('documents')) {
+        const documentOutput = path.join(outputRoot, 'documents');
+        await ensureDirectory(documentOutput);
+        await updateSettings(documentOutput, {
+            apiKey,
+            domain,
+            downloadAttachments,
+            folderType: FolderType.DOCUMENT,
+            outputDir: documentOutput,
+            projectIdOrKey,
+        });
+        logger.log('ドキュメントの取得を開始します...');
+        await exportDocuments({ documentRepository, logger }, {
+            domain,
+            downloadAttachments,
+            outputDir: documentOutput,
+            projectId,
+            projectIdOrKey,
+        });
+        await updateSettings(documentOutput, { lastUpdated: new Date().toISOString() });
+        logger.log('ドキュメントの取得が完了しました');
+    }
+    logger.log('すべてのデータの取得が完了しました！');
+}

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

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

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

@@ -0,0 +1,40 @@
+import { escapeLinkText } from '../../../shared/attachment.js';
+import { wrapBody } from '../../../shared/markdown/body-marker.js';
+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);
+            const link = attachmentLinks?.get(attachment.id);
+            const label = link ? `[${escapeLinkText(attachment.name)}](${link})` : `**${attachment.name}**`;
+            attachmentsSection += `- ${label} (${fileSize} KB) - 作成者: ${attachment.createdUser.name}, 作成日時: ${attachmentDate}\n`;
+        }
+    }
+    // タグリストの作成
+    let tagsSection = '';
+    if (documentDetail.tags && documentDetail.tags.length > 0) {
+        tagsSection = '\n\n## タグ\n';
+        for (const tag of documentDetail.tags) {
+            tagsSection += `- ${tag.name}\n`;
+        }
+    }
+    // 作成者・更新者情報
+    const createdDate = new Date(documentDetail.created).toLocaleString('ja-JP');
+    const updatedDate = new Date(documentDetail.updated).toLocaleString('ja-JP');
+    return `# ${documentDetail.title}
+
+[Backlog Document Link](${backlogDocumentUrl})
+
+**ステータス**: ${documentDetail.statusId}${documentDetail.emoji ? ` ${documentDetail.emoji}` : ''}
+**作成者**: ${documentDetail.createdUser.name}
+**作成日時**: ${createdDate}
+**更新者**: ${documentDetail.updatedUser.name}
+**更新日時**: ${updatedDate}
+
+## 内容
+
+${wrapBody(documentDetail.plain || '（内容なし）')}${attachmentsSection}${tagsSection}`;
+}

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

@@ -0,0 +1,23 @@
+import { ExpectedPaths } from '../../prune/domain/expected-paths.js';
+import { DocumentNode } from './document.js';
+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;
+        id: string;
+        name: string;
+    }>;
+}
+export declare function collectDocumentTreePaths(rootNodes: DocumentNode[]): DocumentTreePaths;
+export declare function resolveDocumentLeafPaths(paths: DocumentTreePaths, titlesById: Map<string, string>): void;

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

@@ -0,0 +1,57 @@
+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側でレイアウト定義を共有する
+export const PARENT_DOCUMENT_INDEX_FILENAME = '00_index.md';
+export function documentFolderPath(currentPath, folderName) {
+    return path.join(currentPath, sanitizeFileName(folderName));
+}
+export function documentFileName(title, asParentIndex) {
+    return asParentIndex ? PARENT_DOCUMENT_INDEX_FILENAME : `${sanitizeFileName(title)}.md`;
+}
+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();
+    const leafNodes = [];
+    const walk = (node, currentPath) => {
+        if (node.children && node.children.length > 0) {
+            const dirPath = documentFolderPath(currentPath, node.name).normalize('NFC');
+            expectedDirs.add(dirPath);
+            expectedFiles.add(path.join(dirPath, PARENT_DOCUMENT_INDEX_FILENAME).normalize('NFC'));
+            for (const child of node.children) {
+                walk(child, dirPath);
+            }
+        }
+        else {
+            leafNodes.push({ currentPath, id: node.id, name: node.name });
+        }
+    };
+    for (const rootNode of rootNodes) {
+        walk(rootNode, '');
+    }
+    return { expectedDirs, expectedFiles, leafNodes };
+}
+// 一覧に現れないリーフは空フォルダの可能性があるため、ディレクトリとname由来ファイルの両方を保護する（誤削除より安全側）
+export function resolveDocumentLeafPaths(paths, titlesById) {
+    for (const leaf of paths.leafNodes) {
+        const title = titlesById.get(leaf.id);
+        if (title === undefined) {
+            paths.expectedDirs.add(path.join(leaf.currentPath, sanitizeFileName(leaf.name)).normalize('NFC'));
+            paths.expectedFiles.add(path.join(leaf.currentPath, `${sanitizeFileName(leaf.name)}.md`).normalize('NFC'));
+            continue;
+        }
+        paths.expectedFiles.add(path.join(leaf.currentPath, `${sanitizeFileName(title)}.md`).normalize('NFC'));
+    }
+}

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

@@ -0,0 +1,7 @@
+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/domain/document-repository.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/document/domain/document-save-plan.d.ts

@@ -0,0 +1,9 @@
+export type DocumentSaveAction = 'delete-stale-parent-index' | 'save' | 'skip-empty-parent' | 'skip-parent-index-collision' | 'skip-unchanged';
+export declare function planDocumentSave(input: {
+    asParentIndex: boolean;
+    body: null | string | undefined;
+    lastUpdated?: string;
+    parentIndexAlreadyWrittenThisRun: boolean;
+    parentIndexExists: boolean;
+    updated: string;
+}): DocumentSaveAction;

package/dist/modules/document/domain/document-save-plan.js

@@ -0,0 +1,15 @@
+// 保存/スキップ/親index削除の判断。本文が空の親はファイルを作らず、空に変更された場合は古い親indexを削除する
+export function planDocumentSave(input) {
+    if (input.asParentIndex && input.parentIndexAlreadyWrittenThisRun) {
+        return 'skip-parent-index-collision';
+    }
+    // 前回の更新日時チェック（親indexがまだ存在しない場合はバックフィルのため未更新でも保存する）
+    const backfillParentIndex = input.asParentIndex && !input.parentIndexExists;
+    if (input.lastUpdated && !backfillParentIndex && new Date(input.updated) <= new Date(input.lastUpdated)) {
+        return 'skip-unchanged';
+    }
+    if (input.asParentIndex && !input.body?.trim()) {
+        return input.parentIndexExists ? 'delete-stale-parent-index' : 'skip-empty-parent';
+    }
+    return 'save';
+}

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

@@ -0,0 +1,50 @@
+export interface DocumentNode {
+    children: DocumentNode[];
+    emoji?: string;
+    emojiType?: string;
+    id: string;
+    name: string;
+    updated?: string;
+}
+export interface DocumentTree {
+    activeTree: {
+        children: DocumentNode[];
+        id: string;
+    };
+}
+export interface DocumentSummary {
+    id: string;
+    title: string;
+}
+export interface DocumentDetail {
+    attachments: Array<{
+        created: string;
+        createdUser: {
+            id: number;
+            name: string;
+        };
+        id: number;
+        name: string;
+        size: number;
+    }>;
+    created: string;
+    createdUser: {
+        id: number;
+        name: string;
+    };
+    emoji?: string;
+    id: string;
+    json: string;
+    plain: string;
+    statusId: number;
+    tags: Array<{
+        id: number;
+        name: string;
+    }>;
+    title: string;
+    updated: string;
+    updatedUser: {
+        id: number;
+        name: string;
+    };
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,3 @@
+import { BacklogHttpClient } from '../../../shared/backlog/http-client.js';
+import { DocumentRepository } from '../domain/document-repository.js';
+export declare function newBacklogDocumentRepository(client: BacklogHttpClient): DocumentRepository;

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

@@ -0,0 +1,35 @@
+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;
+            let offset = 0;
+            for (;;) {
+                // eslint-disable-next-line no-await-in-loop
+                const page = await client.getJson('/documents', {
+                    count: pageSize.toString(),
+                    offset: offset.toString(),
+                    'projectId[]': projectId.toString(),
+                });
+                for (const doc of page) {
+                    titlesById.set(doc.id, doc.title);
+                }
+                if (page.length < pageSize) {
+                    break;
+                }
+                offset += pageSize;
+            }
+            return titlesById;
+        },
+        async fetchDetail(documentId) {
+            return client.getJson(`/documents/${documentId}`);
+        },
+        async fetchTree(projectId) {
+            return client.getJson('/documents/tree', { projectIdOrKey: projectId.toString() });
+        },
+    };
+}

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

@@ -0,0 +1,17 @@
+import { Logger } from '../../../shared/ports.js';
+import { DocumentRepository } from '../domain/document-repository.js';
+export interface ExportDocumentsDeps {
+    documentRepository: DocumentRepository;
+    logger: Logger;
+}
+export interface ExportDocumentsOptions {
+    documentIds?: string[];
+    domain: string;
+    downloadAttachments?: boolean;
+    keyword?: string;
+    lastUpdated?: string;
+    outputDir: string;
+    projectId: number;
+    projectIdOrKey: string;
+}
+export declare function exportDocuments(deps: ExportDocumentsDeps, options: ExportDocumentsOptions): Promise<void>;

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

@@ -0,0 +1,107 @@
+import path from 'node:path';
+import { writeProgress } from '../../../shared/console/progress.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 { 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;
+    logger.log('ドキュメントの取得を開始します...');
+    logger.log('ドキュメントツリーを取得しています...');
+    const documentTree = await documentRepository.fetchTree(options.projectId);
+    logger.log('アクティブなドキュメントツリーを処理します...');
+    const processedDocuments = [];
+    const writtenFiles = new Set();
+    const fetchAndSaveDocument = async (node, currentPath, asParentIndex = false) => {
+        try {
+            if (processedDocuments.includes(node.id)) {
+                return;
+            }
+            if (options.documentIds && options.documentIds.length > 0 && !options.documentIds.includes(node.id)) {
+                return;
+            }
+            processedDocuments.push(node.id);
+            writeProgress(`ドキュメント「${node.name}」を処理中...`);
+            const documentDetail = await documentRepository.fetchDetail(node.id);
+            const fileName = documentFileName(documentDetail.title, asParentIndex);
+            const filePath = path.join(options.outputDir, currentPath, fileName);
+            const action = planDocumentSave({
+                asParentIndex,
+                body: documentDetail.plain,
+                lastUpdated: options.lastUpdated,
+                parentIndexAlreadyWrittenThisRun: writtenFiles.has(filePath),
+                parentIndexExists: asParentIndex && (await fileExists(filePath)),
+                updated: documentDetail.updated,
+            });
+            switch (action) {
+                case 'delete-stale-parent-index': {
+                    await deleteFile(filePath);
+                    await appendLog(options.outputDir, `ドキュメント「${documentDetail.title}」の本文が空になったため ${PARENT_DOCUMENT_INDEX_FILENAME} を削除しました`);
+                    break;
+                }
+                case 'save': {
+                    const backlogDocumentUrl = documentUrl(options.domain, options.projectIdOrKey, node.id);
+                    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;
+                }
+                case 'skip-parent-index-collision': {
+                    logger.warn(`「${node.name}」内に「${PARENT_DOCUMENT_INDEX_FILENAME}」と同名になる子ドキュメントが存在するため、親ドキュメント本文の保存をスキップしました`);
+                    break;
+                }
+                // No default
+            }
+        }
+        catch (error) {
+            logger.warn(`ドキュメント ${node.name} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    /* eslint-disable no-await-in-loop */
+    const processDocumentNode = async (node, currentPath) => {
+        if (node.children && node.children.length > 0) {
+            const folderRelPath = documentFolderPath(currentPath, node.name);
+            await ensureDirectory(path.join(options.outputDir, folderRelPath));
+            for (const child of node.children) {
+                await processDocumentNode(child, folderRelPath);
+            }
+            // 親自身の本文はフォルダ内の親indexとして子の後に保存する
+            await fetchAndSaveDocument(node, folderRelPath, true);
+        }
+        else {
+            await fetchAndSaveDocument(node, currentPath);
+        }
+    };
+    for (const rootNode of documentTree.activeTree.children ?? []) {
+        await processDocumentNode(rootNode, '');
+    }
+    /* eslint-enable no-await-in-loop */
+    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-filter.d.ts

@@ -0,0 +1,2 @@
+import { Issue } from './issue.js';
+export declare function filterIssuesUpdatedSince(issues: Issue[], lastUpdated?: string): Issue[];

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

@@ -0,0 +1,7 @@
+export function filterIssuesUpdatedSince(issues, lastUpdated) {
+    if (!lastUpdated) {
+        return issues;
+    }
+    const lastUpdatedDate = new Date(lastUpdated);
+    return issues.filter((issue) => new Date(issue.updated) > lastUpdatedDate);
+}

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

@@ -0,0 +1,5 @@
+import { CustomField, Issue, IssueAttachment, IssueComment } from './issue.js';
+export declare function createCustomFieldsSection(customFields?: CustomField[]): 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

@@ -0,0 +1,127 @@
+import { escapeLinkText, rewriteInlineImages } from '../../../shared/attachment.js';
+import { wrapBody } from '../../../shared/markdown/body-marker.js';
+// Backlogの変更履歴（changeLog）のfieldを画面表示に合わせた日本語ラベルへ変換する
+const CHANGE_FIELD_LABELS = {
+    actualHours: '実績時間',
+    assigner: '担当者',
+    attachment: '添付ファイル',
+    component: 'カテゴリー',
+    description: '詳細',
+    estimatedHours: '予定時間',
+    issueType: '種別',
+    limitDate: '期限日',
+    milestone: 'マイルストーン',
+    notification: 'お知らせ',
+    parentIssue: '親課題',
+    priority: '優先度',
+    resolution: '完了理由',
+    startDate: '開始日',
+    status: '状態',
+    summary: '件名',
+    version: '発生バージョン',
+};
+// 詳細やカスタム属性の変更値には複数行の長文が入ることがあり、
+// そのまま出すとリスト構造が崩れるため1行化して切り詰める
+function formatChangeValue(value) {
+    if (!value)
+        return '未設定';
+    const singleLine = value.replaceAll(/\s*\n\s*/g, ' ').trim();
+    return singleLine.length > 50 ? `${singleLine.slice(0, 50)}…` : singleLine;
+}
+function formatChange(change) {
+    const label = CHANGE_FIELD_LABELS[change.field] ?? change.field;
+    return `- ${label}: ${formatChangeValue(change.originalValue)} → ${formatChangeValue(change.newValue)}`;
+}
+function buildCommentBody(comment, rewriteBody) {
+    const parts = [];
+    if (comment.content) {
+        parts.push(rewriteBody(comment.content));
+    }
+    if (comment.changeLog && comment.changeLog.length > 0) {
+        parts.push(['**変更内容**', ...comment.changeLog.map((change) => formatChange(change))].join('\n'));
+    }
+    return parts.length > 0 ? parts.join('\n\n') : '(内容なし)';
+}
+export function createCustomFieldsSection(customFields) {
+    if (!customFields || customFields.length === 0) {
+        return '';
+    }
+    let customFieldsSection = '\n\n## カスタム属性\n\n| 属性名 | 値 |\n|--------|----|\n';
+    for (const customField of customFields) {
+        let fieldValue = 'なし';
+        if (customField.value !== null && customField.value !== undefined) {
+            if (Array.isArray(customField.value)) {
+                // 配列の場合（複数選択など）
+                fieldValue = customField.value
+                    .map((item) => item.name || item.value || String(item))
+                    .join(', ');
+            }
+            else if (typeof customField.value === 'object' && customField.value !== null) {
+                // オブジェクトの場合（単一選択など）
+                const valueObj = customField.value;
+                fieldValue = valueObj.name || valueObj.value || String(customField.value);
+            }
+            else {
+                // プリミティブ値の場合
+                fieldValue = String(customField.value);
+            }
+        }
+        // テーブル内では改行をHTMLの<br>タグに変換し、パイプ文字をエスケープ
+        const escapedFieldValue = fieldValue.replaceAll('|', String.raw `\|`).replaceAll('\n', '<br>');
+        customFieldsSection += `| ${customField.name} | ${escapedFieldValue} |\n`;
+    }
+    return customFieldsSection;
+}
+// ダウンロード済みの添付はローカルへの相対リンク付き、未ダウンロードはメタデータのみを出力する
+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 '';
+    }
+    let commentsSection = '\n\n## コメント\n';
+    let commentIndex = 1;
+    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, rewriteBody)}\n\n---\n`;
+        commentIndex++;
+    }
+    // 最後の区切り線を削除
+    return commentsSection.slice(0, -5);
+}
+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') : '未設定';
+    return `# ${issue.summary}
+
+## 基本情報
+- 課題キー: ${issue.issueKey}
+- 種別: ${issue.issueType.name}
+- ステータス: ${issue.status.name}
+- 優先度: ${issue.priority.name}
+- 担当者: ${assigneeName}
+- 開始日: ${startDate}
+- 期限日: ${dueDate}
+- 作成日時: ${new Date(issue.created).toLocaleString('ja-JP')}
+- 更新日時: ${new Date(issue.updated).toLocaleString('ja-JP')}
+- [Backlog Issue Link](${backlogIssueUrl})${customFieldsSection}${attachmentsSection}
+
+## 詳細
+
+${wrapBody(issue.description ? rewriteBody(issue.description) : '詳細情報なし')}${commentsSection}`;
+}

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

@@ -0,0 +1,34 @@
+import { ExpectedPaths } from '../../prune/domain/expected-paths.js';
+import { Issue, IssueAttachment } from './issue.js';
+export declare function issueFileName(issue: {
+    issueKey: string;
+    summary: string;
+}, useIssueKey: boolean): string;
+export declare function issueRelativeDir(issue: {
+    created: string;
+    issueKey: string;
+}, useIssueKeyFolder: boolean): string;
+export declare function issueRelativePath(issue: {
+    created: string;
+    issueKey: string;
+    summary: string;
+}, options: {
+    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;
+    issueKeyFolder?: boolean;
+}): ExpectedPaths;