backlog-exporter 0.7.3 → 1.1.0

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

@@ -0,0 +1,42 @@
+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';
+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));
+}
+// issueKeyFolderありなら課題フォルダ直下のattachments/、なしなら年フォルダのattachments/{課題キー}/
+function attachmentDirSegments(issueKey, useIssueKeyFolder) {
+    return useIssueKeyFolder ? ['attachments'] : ['attachments', issueKey];
+}
+export function attachmentRelativePath(issue, attachment, options) {
+    return path.join(issueRelativeDir(issue, options.issueKeyFolder ?? false), ...attachmentDirSegments(issue.issueKey, options.issueKeyFolder ?? false), attachmentFileName(attachment));
+}
+export function attachmentMarkdownLink(issue, attachment, options) {
+    const segments = attachmentDirSegments(issue.issueKey, options.issueKeyFolder ?? false);
+    return encodeLinkDestination(['.', ...segments, attachmentFileName(attachment)].join('/'));
+}
+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,12 @@
+import { Issue, IssueComment } from './issue.js';
+export interface IssueRepository {
+    downloadAttachment(issueIdOrKey: string, attachmentId: number): Promise<ArrayBuffer>;
+    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,53 @@
+export interface Issue {
+    assignee: null | {
+        id: number;
+        name: string;
+    };
+    attachments?: IssueAttachment[];
+    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 IssueAttachment {
+    id: number;
+    name: string;
+    size: number;
+}
+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,41 @@
+export function newBacklogIssueRepository(client) {
+    return {
+        async downloadAttachment(issueIdOrKey, attachmentId) {
+            return client.getBinary(`/issues/${issueIdOrKey}/attachments/${attachmentId}`);
+        },
+        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,19 @@
+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;
+    downloadAttachments?: boolean;
+    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,113 @@
+import path from 'node:path';
+import { writeProgress } from '../../../shared/console/progress.js';
+import { fileSize, writeBinaryFile, 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 { attachmentMarkdownLink, attachmentRelativePath, 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 attachmentLinks = options.downloadAttachments
+        ? await downloadIssueAttachments(deps, issue, options)
+        : undefined;
+    const filePath = path.join(options.outputDir, issueRelativePath(issue, options));
+    await writeMarkdownFile(filePath, buildIssueMarkdown(issue, comments, backlogIssueUrl, attachmentLinks));
+    await appendLog(options.outputDir, `課題「${issue.summary}」を更新しました: ${backlogIssueUrl}`);
+}
+// 保存できた添付のみリンク化する。個々の失敗は警告に留め、課題本体の保存は続行する
+async function downloadIssueAttachments(deps, issue, options) {
+    const links = new Map();
+    for (const attachment of issue.attachments ?? []) {
+        const absolutePath = path.join(options.outputDir, attachmentRelativePath(issue, attachment, options));
+        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.issueRepository.downloadAttachment(issue.issueKey, attachment.id);
+                // eslint-disable-next-line no-await-in-loop
+                await writeBinaryFile(absolutePath, data);
+            }
+            links.set(attachment.id, attachmentMarkdownLink(issue, attachment, options));
+        }
+        catch (error) {
+            deps.logger.warn(`課題 ${issue.issueKey} の添付ファイル「${attachment.name}」の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return links;
+}

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>;
+}

package/dist/modules/prune/domain/expected-paths.js

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

package/dist/modules/prune/domain/prune-target.d.ts

@@ -0,0 +1,3 @@
+import { Settings } from '../../settings/domain/settings.js';
+export type PruneTarget = 'document' | 'issue' | 'missing-folder-type' | 'not-target' | 'wiki';
+export declare function classifyPruneTarget(settings: Settings): PruneTarget;

package/dist/modules/prune/domain/prune-target.js

@@ -0,0 +1,21 @@
+import { FolderType } from '../../settings/domain/settings.js';
+// folderTypeが無いのは旧バージョンの設定ファイル。無言でスキップせず理由を伝えるためnot-targetと区別する
+export function classifyPruneTarget(settings) {
+    switch (settings.folderType) {
+        case FolderType.DOCUMENT: {
+            return 'document';
+        }
+        case FolderType.ISSUE: {
+            return 'issue';
+        }
+        case FolderType.WIKI: {
+            return 'wiki';
+        }
+        case undefined: {
+            return 'missing-folder-type';
+        }
+        default: {
+            return 'not-target';
+        }
+    }
+}

package/dist/modules/prune/repository/prune-walker.d.ts

@@ -0,0 +1,7 @@
+import { ExpectedPaths } from '../domain/expected-paths.js';
+export declare function pruneLocalMarkdownFiles(options: {
+    expected: ExpectedPaths;
+    label: string;
+    log: (message: string) => void;
+    outputDir: string;
+}): Promise<number>;

package/dist/modules/prune/repository/prune-walker.js

@@ -0,0 +1,44 @@
+import * as fs from 'node:fs/promises';
+import path from 'node:path';
+import { appendLog } from '../../../shared/storage/update-log.js';
+// 期待パス集合に含まれない .md ファイルと空ディレクトリを削除する。
+// 削除対象は .md のみで、設定ファイル・ログ・ユーザーが置いた他のファイルには触れない。
+// 比較はNFC正規化（macOSのNFDとAPIレスポンスのNFCの差異吸収）＋小文字化
+// （大文字小文字非区別FSでは大小文字のみのリネーム後もディスク上のエントリ名が旧表記のまま残るため。
+// 区別するFSでは旧表記が残り得るが、誤削除より安全側に倒す）で行う。
+export async function pruneLocalMarkdownFiles(options) {
+    const expectedFiles = new Set([...options.expected.expectedFiles].map((p) => p.toLowerCase()));
+    const expectedDirs = new Set([...options.expected.expectedDirs].map((p) => p.toLowerCase()));
+    let prunedCount = 0;
+    /* eslint-disable no-await-in-loop */
+    const pruneDirectory = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            const relativePath = path.relative(options.outputDir, fullPath).normalize('NFC');
+            if (entry.isDirectory()) {
+                // 添付ファイルの保存先。Wiki・ドキュメントのpruneは一覧APIしか呼ばず添付の期待パスを持てないため、
+                // attachments/ 配下は走査せず丸ごと保護する（.md形式の添付の誤削除防止）
+                if (entry.name === 'attachments') {
+                    continue;
+                }
+                await pruneDirectory(fullPath);
+                const remaining = await fs.readdir(fullPath);
+                if (remaining.length === 0 && !expectedDirs.has(relativePath.toLowerCase())) {
+                    await fs.rmdir(fullPath);
+                    options.log(`空のディレクトリを削除しました: ${relativePath}`);
+                }
+            }
+            else if (entry.name.endsWith('.md') && !expectedFiles.has(relativePath.toLowerCase())) {
+                await fs.unlink(fullPath);
+                prunedCount++;
+                options.log(`Backlog上に存在しない${options.label}を削除しました: ${relativePath}`);
+                await appendLog(options.outputDir, `${options.label}「${relativePath}」を削除しました（Backlog上に存在しないため）`);
+            }
+        }
+    };
+    /* eslint-enable no-await-in-loop */
+    await pruneDirectory(options.outputDir);
+    options.log(`${prunedCount}件の不要な${options.label}ファイルを削除しました。`);
+    return prunedCount;
+}

package/dist/modules/prune/use-case/prune-directories.d.ts

@@ -0,0 +1,28 @@
+import { Logger } from '../../../shared/ports.js';
+import { DocumentRepository } from '../../document/domain/document-repository.js';
+import { IssueRepository } from '../../issue/domain/issue-repository.js';
+import { ProjectRepository } from '../../project/domain/project-repository.js';
+import { WikiRepository } from '../../wiki/domain/wiki-repository.js';
+export interface PruneFlags {
+    apiKey?: string;
+    domain?: string;
+    projectIdOrKey?: string;
+}
+export interface PruneDeps {
+    createRepositories: (connection: {
+        apiKey: string;
+        domain: string;
+        onRateLimitExceeded?: (waitSeconds: number) => void;
+    }) => {
+        documentRepository: DocumentRepository;
+        issueRepository: IssueRepository;
+        projectRepository: ProjectRepository;
+        wikiRepository: WikiRepository;
+    };
+    logger: Logger;
+}
+export declare function pruneDirectories(deps: PruneDeps, options: {
+    confirmDirectory: (directory: string) => Promise<boolean>;
+    flags: PruneFlags;
+    rootDir: string;
+}): Promise<void>;

package/dist/modules/prune/use-case/prune-directories.js

@@ -0,0 +1,74 @@
+import { resolveApiKey } from '../../../shared/config/env.js';
+import { assertDirectoryExists } from '../../../shared/storage/markdown-store.js';
+import { findSettingsDirectories, loadSettings } from '../../settings/repository/settings-store.js';
+import { classifyPruneTarget } from '../domain/prune-target.js';
+import { pruneDocuments, pruneIssues, pruneWikis } from './prune-exports.js';
+export async function pruneDirectories(deps, options) {
+    const { logger } = deps;
+    await assertDirectoryExists(options.rootDir);
+    const directories = await findSettingsDirectories(options.rootDir, (dir) => {
+        logger.warn(`ディレクトリの読み取りに失敗しました: ${dir}`);
+    });
+    if (directories.length === 0) {
+        logger.warn(`設定ファイル（backlog-settings.json）が見つかりませんでした: ${options.rootDir}`);
+        return;
+    }
+    for (const directory of directories) {
+        // eslint-disable-next-line no-await-in-loop
+        await pruneDirectory(deps, directory, options.flags, options.confirmDirectory);
+    }
+}
+async function pruneDirectory(deps, targetDir, flags, confirmDirectory) {
+    const { logger } = deps;
+    const settings = await loadSettings(targetDir);
+    const target = classifyPruneTarget(settings);
+    if (target === 'missing-folder-type') {
+        logger.warn(`${targetDir}: 設定ファイルに folderType がないためスキップします（update コマンドを実行すると保存されます）`);
+        return;
+    }
+    if (target === 'not-target') {
+        return;
+    }
+    const domain = flags.domain || settings.domain;
+    const projectIdOrKey = flags.projectIdOrKey || settings.projectIdOrKey;
+    if (!domain) {
+        logger.warn(`${targetDir}: ドメインが指定されていません。スキップします。`);
+        return;
+    }
+    if (!projectIdOrKey) {
+        logger.warn(`${targetDir}: プロジェクトID/キーが指定されていません。スキップします。`);
+        return;
+    }
+    const apiKey = flags.apiKey ||
+        settings.apiKey ||
+        resolveApiKey(undefined, () => logger.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します'));
+    if (!apiKey) {
+        logger.warn(`${targetDir}: APIキーが指定されていません。--apiKey フラグまたは BACKLOG_API_KEY 環境変数で設定してください。`);
+        return;
+    }
+    const confirmed = await confirmDirectory(targetDir);
+    if (!confirmed) {
+        return;
+    }
+    const { documentRepository, issueRepository, projectRepository, wikiRepository } = deps.createRepositories({
+        apiKey,
+        domain,
+        onRateLimitExceeded: (waitSeconds) => logger.log(`レート制限の上限に達しました。${waitSeconds}秒待機します...`),
+    });
+    if (target === 'wiki') {
+        await pruneWikis({ logger, wikiRepository }, { outputDir: targetDir, projectIdOrKey });
+    }
+    else {
+        const projectId = await projectRepository.resolveProjectId(projectIdOrKey);
+        await (target === 'issue'
+            ? pruneIssues({ issueRepository, logger }, {
+                // 保存時の命名を再現するため、エクスポート時に保存された設定を使う
+                issueKeyFileName: settings.issueKeyFileName,
+                issueKeyFolder: settings.issueKeyFolder,
+                outputDir: targetDir,
+                projectId,
+            })
+            : pruneDocuments({ documentRepository, logger }, { outputDir: targetDir, projectId }));
+    }
+    logger.log(`${targetDir} のpruneが完了しました！`);
+}

package/dist/modules/prune/use-case/prune-exports.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from '../../../shared/ports.js';
+import { DocumentRepository } from '../../document/domain/document-repository.js';
+import { IssueRepository } from '../../issue/domain/issue-repository.js';
+import { WikiRepository } from '../../wiki/domain/wiki-repository.js';
+export declare function pruneDocuments(deps: {
+    documentRepository: DocumentRepository;
+    logger: Logger;
+}, options: {
+    outputDir: string;
+    projectId: number;
+}): Promise<number>;
+export declare function pruneWikis(deps: {
+    logger: Logger;
+    wikiRepository: WikiRepository;
+}, options: {
+    outputDir: string;
+    projectIdOrKey: string;
+}): Promise<number>;
+export declare function pruneIssues(deps: {
+    issueRepository: IssueRepository;
+    logger: Logger;
+}, options: {
+    issueKeyFileName?: boolean;
+    issueKeyFolder?: boolean;
+    outputDir: string;
+    projectId: number;
+}): Promise<number>;

package/dist/modules/prune/use-case/prune-exports.js

@@ -0,0 +1,74 @@
+import { collectDocumentTreePaths, resolveDocumentLeafPaths } from '../../document/domain/document-path.js';
+import { buildIssueExpectedPaths } from '../../issue/domain/issue-path.js';
+import { buildWikiExpectedPaths } from '../../wiki/domain/wiki-path.js';
+import { pruneLocalMarkdownFiles } from '../repository/prune-walker.js';
+export async function pruneDocuments(deps, options) {
+    const { documentRepository, logger } = deps;
+    logger.log('Backlogのドキュメントツリーを取得しています...');
+    const documentTree = await documentRepository.fetchTree(options.projectId);
+    const expected = collectDocumentTreePaths(documentTree.activeTree.children);
+    // 保存時のファイル名は詳細のtitle基準のため、一覧APIでタイトルを解決してから期待パスを確定する
+    let titlesById = new Map();
+    if (expected.leafNodes.length > 0) {
+        logger.log(`${expected.leafNodes.length}件のドキュメントの正規ファイル名を確認しています...`);
+        try {
+            titlesById = await documentRepository.fetchAllTitles(options.projectId);
+        }
+        catch (error) {
+            // 一覧に欠けが生じると実在ドキュメントを誤削除するため、何も削除せずに中止する
+            throw new Error(`ドキュメント一覧の取得に失敗しました。誤削除を防ぐため、何も削除せずに中止します: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    resolveDocumentLeafPaths(expected, titlesById);
+    return pruneLocalMarkdownFiles({
+        expected,
+        label: 'ドキュメント',
+        log: (message) => logger.log(message),
+        outputDir: options.outputDir,
+    });
+}
+export async function pruneWikis(deps, options) {
+    const { logger, wikiRepository } = deps;
+    logger.log('BacklogのWiki一覧を取得しています...');
+    const wikis = await wikiRepository.fetchWikis(options.projectIdOrKey);
+    const expected = buildWikiExpectedPaths(wikis.map((wiki) => wiki.name));
+    return pruneLocalMarkdownFiles({
+        expected,
+        label: 'Wiki',
+        log: (message) => logger.log(message),
+        outputDir: options.outputDir,
+    });
+}
+export async function pruneIssues(deps, options) {
+    const { issueRepository, logger } = deps;
+    logger.log('Backlogの課題一覧を取得しています...');
+    // 期待集合が途中で切れると実在課題のファイルを誤削除するため、capを設けず全件を取得し、
+    // 取得に失敗した場合は何も削除せずに中止する
+    const issues = [];
+    const pageSize = 100;
+    try {
+        for (;;) {
+            // eslint-disable-next-line no-await-in-loop
+            const page = await issueRepository.fetchPage({
+                count: pageSize,
+                offset: issues.length,
+                projectId: options.projectId,
+            });
+            issues.push(...page);
+            if (page.length < pageSize) {
+                break;
+            }
+        }
+    }
+    catch (error) {
+        throw new Error(`課題一覧の取得に失敗しました。誤削除を防ぐため、何も削除せずに中止します: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    logger.log(`${issues.length}件の課題が見つかりました。`);
+    const expected = buildIssueExpectedPaths(issues, options);
+    return pruneLocalMarkdownFiles({
+        expected,
+        label: '課題',
+        log: (message) => logger.log(message),
+        outputDir: options.outputDir,
+    });
+}

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

@@ -0,0 +1,16 @@
+export declare enum FolderType {
+    DOCUMENT = "document",
+    ISSUE = "issue",
+    WIKI = "wiki"
+}
+export interface Settings {
+    apiKey?: string;
+    domain?: string;
+    downloadAttachments?: boolean;
+    folderType?: FolderType;
+    issueKeyFileName?: boolean;
+    issueKeyFolder?: boolean;
+    lastUpdated?: string;
+    outputDir?: string;
+    projectIdOrKey?: string;
+}

package/dist/modules/settings/domain/settings.js

@@ -0,0 +1,6 @@
+export var FolderType;
+(function (FolderType) {
+    FolderType["DOCUMENT"] = "document";
+    FolderType["ISSUE"] = "issue";
+    FolderType["WIKI"] = "wiki";
+})(FolderType || (FolderType = {}));