backlog-exporter 0.7.2 → 1.0.0

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,31 @@
+export function newBacklogDocumentRepository(client) {
+    return {
+        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,16 @@
+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;
+    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,82 @@
+import path from 'node:path';
+import { writeProgress } from '../../../shared/console/progress.js';
+import { deleteFile, ensureDirectory, fileExists, 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 { 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);
+                    await writeMarkdownFile(filePath, buildDocumentMarkdown(documentDetail, backlogDocumentUrl));
+                    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('ドキュメントのダウンロードが完了しました！');
+}

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,4 @@
+import { CustomField, Issue, 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;

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

@@ -0,0 +1,112 @@
+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) {
+    const parts = [];
+    if (comment.content) {
+        parts.push(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 buildCommentsSection(comments, backlogIssueUrl) {
+    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)}\n\n---\n`;
+        commentIndex++;
+    }
+    // 最後の区切り線を削除
+    return commentsSection.slice(0, -5);
+}
+export function buildIssueMarkdown(issue, comments, backlogIssueUrl) {
+    const commentsSection = buildCommentsSection(comments, backlogIssueUrl);
+    const customFieldsSection = createCustomFieldsSection(issue.customFields);
+    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}
+
+## 詳細
+
+${wrapBody(issue.description || '詳細情報なし')}${commentsSection}`;
+}

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

@@ -0,0 +1,23 @@
+import { ExpectedPaths } from '../../prune/domain/expected-paths.js';
+import { Issue } 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 issueUrl(domain: string, issueKey: string): string;
+export declare function buildIssueExpectedPaths(issues: Issue[], options: {
+    issueKeyFileName?: boolean;
+    issueKeyFolder?: boolean;
+}): ExpectedPaths;

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

@@ -0,0 +1,30 @@
+import path from 'node:path';
+import { backlogOrigin } from '../../../shared/backlog-url.js';
+import { sanitizeFileName } from '../../../shared/file-name.js';
+export function issueFileName(issue, useIssueKey) {
+    return useIssueKey ? `${issue.issueKey}.md` : `${sanitizeFileName(issue.summary)}.md`;
+}
+export function issueRelativeDir(issue, useIssueKeyFolder) {
+    const createdYear = new Date(issue.created).getFullYear().toString();
+    return useIssueKeyFolder ? path.join(createdYear, issue.issueKey) : createdYear;
+}
+export function issueRelativePath(issue, options) {
+    return path.join(issueRelativeDir(issue, options.issueKeyFolder ?? false), issueFileName(issue, options.issueKeyFileName ?? false));
+}
+export function issueUrl(domain, issueKey) {
+    return `${backlogOrigin(domain)}/view/${issueKey}`;
+}
+// prune用: 保存時と同じ命名ロジックで期待パス集合を構築する
+export function buildIssueExpectedPaths(issues, options) {
+    const expectedFiles = new Set();
+    const expectedDirs = new Set();
+    for (const issue of issues) {
+        expectedFiles.add(issueRelativePath(issue, options).normalize('NFC'));
+        let dir = issueRelativeDir(issue, options.issueKeyFolder ?? false);
+        while (dir && dir !== '.') {
+            expectedDirs.add(dir.normalize('NFC'));
+            dir = path.dirname(dir);
+        }
+    }
+    return { expectedDirs, expectedFiles };
+}

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

@@ -0,0 +1,11 @@
+import { Issue, IssueComment } from './issue.js';
+export interface IssueRepository {
+    fetchAllComments(issueKey: string): Promise<IssueComment[]>;
+    fetchByIdOrKey(issueIdOrKey: string): Promise<Issue>;
+    fetchPage(options: {
+        count: number;
+        offset: number;
+        projectId: number;
+        statusId?: string;
+    }): Promise<Issue[]>;
+}

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

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

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

@@ -0,0 +1,47 @@
+export interface Issue {
+    assignee: null | {
+        id: number;
+        name: string;
+    };
+    created: string;
+    customFields: CustomField[];
+    description: string;
+    dueDate: null | string;
+    id: number;
+    issueKey: string;
+    issueType: {
+        id: number;
+        name: string;
+    };
+    priority: {
+        id: number;
+        name: string;
+    };
+    startDate: null | string;
+    status: {
+        id: number;
+        name: string;
+    };
+    summary: string;
+    updated: string;
+}
+export interface CustomField {
+    id: number;
+    name: string;
+    value: unknown;
+}
+export interface IssueComment {
+    changeLog?: IssueCommentChange[];
+    content: null | string;
+    created: string;
+    createdUser: {
+        id: number;
+        name: string;
+    };
+    id: number;
+}
+export interface IssueCommentChange {
+    field: string;
+    newValue: null | string;
+    originalValue: null | string;
+}

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

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

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

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

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

@@ -0,0 +1,38 @@
+export function newBacklogIssueRepository(client) {
+    return {
+        async fetchAllComments(issueKey) {
+            const allComments = [];
+            let minId;
+            for (;;) {
+                const params = { count: '100' };
+                if (minId !== undefined) {
+                    params.minId = minId.toString();
+                }
+                // eslint-disable-next-line no-await-in-loop
+                const comments = await client.getJson(`/issues/${issueKey}/comments`, params);
+                allComments.push(...comments);
+                if (comments.length < 100) {
+                    break;
+                }
+                minId = comments.at(-1).id + 1;
+            }
+            // コメントを古い順（昇順）に並び替える
+            allComments.sort((a, b) => new Date(a.created).getTime() - new Date(b.created).getTime());
+            return allComments;
+        },
+        async fetchByIdOrKey(issueIdOrKey) {
+            return client.getJson(`/issues/${issueIdOrKey}`);
+        },
+        async fetchPage(options) {
+            const params = {
+                count: options.count.toString(),
+                offset: options.offset.toString(),
+                'projectId[]': options.projectId.toString(),
+            };
+            if (options.statusId) {
+                params['statusId[]'] = options.statusId;
+            }
+            return client.getJson('/issues', params);
+        },
+    };
+}

package/dist/modules/issue/use-case/export-issues.d.ts

@@ -0,0 +1,18 @@
+import { Logger } from '../../../shared/ports.js';
+import { IssueRepository } from '../domain/issue-repository.js';
+export interface ExportIssuesDeps {
+    issueRepository: IssueRepository;
+    logger: Logger;
+}
+export interface ExportIssuesOptions {
+    count?: number;
+    domain: string;
+    issueIdOrKeys?: string[];
+    issueKeyFileName?: boolean;
+    issueKeyFolder?: boolean;
+    lastUpdated?: string;
+    outputDir: string;
+    projectId: number;
+    statusId?: string;
+}
+export declare function exportIssues(deps: ExportIssuesDeps, options: ExportIssuesOptions): Promise<void>;

package/dist/modules/issue/use-case/export-issues.js

@@ -0,0 +1,87 @@
+import path from 'node:path';
+import { writeProgress } from '../../../shared/console/progress.js';
+import { writeMarkdownFile } from '../../../shared/storage/markdown-store.js';
+import { appendLog } from '../../../shared/storage/update-log.js';
+import { filterIssuesUpdatedSince } from '../domain/issue-filter.js';
+import { buildIssueMarkdown } from '../domain/issue-markdown.js';
+import { issueRelativePath, issueUrl } from '../domain/issue-path.js';
+export async function exportIssues(deps, options) {
+    const { logger } = deps;
+    logger.log('課題の取得を開始します...');
+    const allIssues = options.issueIdOrKeys && options.issueIdOrKeys.length > 0
+        ? await fetchIssuesByIdOrKeys(deps, options.issueIdOrKeys)
+        : await fetchAllIssues(deps, options);
+    logger.log(`\n合計 ${allIssues.length}件の課題が見つかりました。`);
+    const filteredIssues = filterIssuesUpdatedSince(allIssues, options.lastUpdated);
+    if (options.lastUpdated) {
+        logger.log(`前回の更新日時(${options.lastUpdated})以降に更新された${filteredIssues.length}件の課題を処理します。`);
+    }
+    if (filteredIssues.length === 0) {
+        logger.log('更新が必要な課題はありません。');
+        return;
+    }
+    logger.log('課題を保存しています...');
+    for (const [index, issue] of filteredIssues.entries()) {
+        try {
+            writeProgress(`課題を保存中... (${index + 1}/${filteredIssues.length}件)`);
+            // eslint-disable-next-line no-await-in-loop
+            await saveIssue(deps, issue, options);
+        }
+        catch (error) {
+            logger.warn(`課題 ${issue.issueKey} の保存に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    logger.log('\n課題のダウンロードが完了しました！');
+}
+async function fetchIssuesByIdOrKeys(deps, issueIdOrKeys) {
+    const issues = [];
+    for (const [index, issueIdOrKey] of issueIdOrKeys.entries()) {
+        try {
+            writeProgress(`課題を取得中... (${index + 1}/${issueIdOrKeys.length}件)`);
+            // eslint-disable-next-line no-await-in-loop
+            issues.push(await deps.issueRepository.fetchByIdOrKey(issueIdOrKey));
+        }
+        catch (error) {
+            deps.logger.warn(`課題 ${issueIdOrKey} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return issues;
+}
+async function fetchAllIssues(deps, options) {
+    const pageSize = Math.min(options.count ?? 5000, 100);
+    const issues = [];
+    try {
+        for (;;) {
+            writeProgress(`課題を取得中... (${issues.length}件取得済み)`);
+            // eslint-disable-next-line no-await-in-loop
+            const page = await deps.issueRepository.fetchPage({
+                count: pageSize,
+                offset: issues.length,
+                projectId: options.projectId,
+                statusId: options.statusId,
+            });
+            issues.push(...page);
+            if (page.length < pageSize) {
+                break;
+            }
+        }
+    }
+    catch (error) {
+        throw new Error(`課題の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return issues;
+}
+async function saveIssue(deps, issue, options) {
+    const backlogIssueUrl = issueUrl(options.domain, issue.issueKey);
+    // コメント取得に失敗しても課題本体は保存する
+    let comments = [];
+    try {
+        comments = await deps.issueRepository.fetchAllComments(issue.issueKey);
+    }
+    catch (error) {
+        deps.logger.warn(`課題 ${issue.issueKey} のコメント取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const filePath = path.join(options.outputDir, issueRelativePath(issue, options));
+    await writeMarkdownFile(filePath, buildIssueMarkdown(issue, comments, backlogIssueUrl));
+    await appendLog(options.outputDir, `課題「${issue.summary}」を更新しました: ${backlogIssueUrl}`);
+}

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

@@ -0,0 +1,3 @@
+export interface ProjectRepository {
+    resolveProjectId(projectIdOrKey: string): Promise<number>;
+}

package/dist/modules/project/domain/project-repository.js

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

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

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

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

@@ -0,0 +1,17 @@
+export function newBacklogProjectRepository(client) {
+    return {
+        async resolveProjectId(projectIdOrKey) {
+            // 数値の場合はそのままプロジェクトIDとして返す
+            if (!Number.isNaN(Number(projectIdOrKey))) {
+                return Number(projectIdOrKey);
+            }
+            try {
+                const projectData = await client.getJson(`/projects/${projectIdOrKey}`);
+                return projectData.id;
+            }
+            catch (error) {
+                throw new Error(`プロジェクトキー "${projectIdOrKey}" からプロジェクトIDの取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+}

package/dist/modules/prune/domain/expected-paths.d.ts

@@ -0,0 +1,4 @@
+export interface ExpectedPaths {
+    expectedDirs: Set<string>;
+    expectedFiles: Set<string>;
+}