backlog-exporter 0.7.2 → 1.0.0

package/dist/commands/update/index.js

@@ -1,13 +1,10 @@
 import { Args, Command, Flags } from '@oclif/core';
-import * as dotenv from 'dotenv';
-import { access, readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { downloadDocuments, downloadIssues, downloadWikis } from '../../utils/backlog-api.js';
-import { validateAndGetProjectId } from '../../utils/backlog.js';
-import { createOutputDirectory, getApiKey } from '../../utils/common.js';
-import { FolderType, getSettingsFilePath, loadSettings, updateSettings } from '../../utils/settings.js';
+import process from 'node:process';
+import { createBacklogRepositories } from '../../composition/backlog-repositories.js';
+import { updateExports } from '../../modules/update/use-case/update-exports.js';
+import { loadDotenv } from '../../shared/config/env.js';
 // .envファイルを読み込む
-dotenv.config();
+loadDotenv();
 export default class Update extends Command {
     static args = {
         directory: Args.string({
@@ -37,6 +34,15 @@ export default class Update extends Command {
 `,
         `<%= config.bin %> <%= command.id %> --issueKeyFileName --issueKeyFolder
 課題キーでフォルダを作成し、ファイル名も課題キーにする
+`,
+        `<%= config.bin %> <%= command.id %> --issueIdOrKey PROJECT-1,PROJECT-2
+指定した課題（IDまたはキー）のみを再取得する（全件差分更新は行わない）
+`,
+        `<%= config.bin %> <%= command.id %> --wikiId 12345,12346
+指定したWiki（ID）のみを再取得する（全件差分更新は行わない）
+`,
+        `<%= config.bin %> <%= command.id %> --documentId abc123,def456
+指定したドキュメント（ID）のみを再取得する（全件差分更新は行わない）
 `,
     ];
     static flags = {
@@ -44,6 +50,10 @@ export default class Update extends Command {
             description: 'Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)',
             required: false,
         }),
+        documentId: Flags.string({
+            description: '指定したドキュメント（ID）のみを再取得する（カンマ区切りで複数指定可能）',
+            required: false,
+        }),
         documentsOnly: Flags.boolean({
             description: 'ドキュメントのみを更新する',
             required: false,
@@ -57,6 +67,10 @@ export default class Update extends Command {
             description: '確認プロンプトをスキップする',
             required: false,
         }),
+        issueIdOrKey: Flags.string({
+            description: '指定した課題（IDまたはキー）のみを再取得する（カンマ区切りで複数指定可能）',
+            required: false,
+        }),
         issueKeyFileName: Flags.boolean({
             description: 'ファイル名を課題キーにする',
             required: false,
@@ -73,6 +87,10 @@ export default class Update extends Command {
             description: 'Backlog project ID or key',
             required: false,
         }),
+        wikiId: Flags.string({
+            description: '指定したWiki（ID）のみを再取得する（カンマ区切りで複数指定可能）',
+            required: false,
+        }),
         wikisOnly: Flags.boolean({
             description: 'Wikiのみを更新する',
             required: false,
@@ -82,263 +100,13 @@ export default class Update extends Command {
         const { args, flags } = await this.parse(Update);
         // 更新対象のディレクトリを決定（指定がなければカレントディレクトリ）
         const targetDir = args.directory || process.cwd();
+        const logger = { log: (message) => this.log(message), warn: (message) => this.warn(message) };
         try {
-            // 設定ファイルを探索して更新を実行
-            await this.findAndUpdateSettings(targetDir, flags);
+            await updateExports({ createRepositories: createBacklogRepositories, logger }, targetDir, flags);
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.error(`更新に失敗しました: ${errorMessage}`);
         }
     }
-    // 確認プロンプトの表示
-    async confirmUpdate(options) {
-        if (options.force)
-            return true;
-        this.log(`以下の設定で更新を実行します:`);
-        this.log(`- ディレクトリ: ${options.targetDir}`);
-        this.log(`- ドメイン: ${options.domain}`);
-        this.log(`- プロジェクト: ${options.projectIdOrKey}`);
-        if (options.folderType) {
-            this.log(`- フォルダタイプ: ${options.folderType}`);
-        }
-        const updateTargets = [];
-        if (options.updateIssues)
-            updateTargets.push('課題');
-        if (options.updateWikis)
-            updateTargets.push('Wiki');
-        if (options.updateDocuments)
-            updateTargets.push('ドキュメント');
-        this.log(`- 更新対象: ${updateTargets.join('・')}`);
-        // 確認プロンプトを表示
-        this.log('更新を実行しますか？ (y/n)');
-        process.stdin.resume();
-        process.stdin.setEncoding('utf8');
-        const response = await new Promise((resolve) => {
-            process.stdin.once('data', (data) => {
-                const input = data.toString().trim().toLowerCase();
-                resolve(input === 'y' || input === 'yes');
-                process.stdin.pause();
-            });
-        });
-        if (!response) {
-            this.log('更新をキャンセルしました');
-        }
-        return response;
-    }
-    // 更新対象の決定
-    determineUpdateTargets(folderType, documentsOnly, issuesOnly, wikisOnly) {
-        let updateIssues = !wikisOnly && !documentsOnly;
-        let updateWikis = !issuesOnly && !documentsOnly;
-        let updateDocuments = !issuesOnly && !wikisOnly;
-        // フォルダタイプに応じて更新対象を決定
-        switch (folderType) {
-            case FolderType.DOCUMENT: {
-                updateIssues = false;
-                updateWikis = false;
-                updateDocuments = true;
-                break;
-            }
-            case FolderType.ISSUE: {
-                updateIssues = true;
-                updateWikis = false;
-                updateDocuments = false;
-                break;
-            }
-            case FolderType.WIKI: {
-                updateIssues = false;
-                updateWikis = true;
-                updateDocuments = false;
-                break;
-            }
-        }
-        return { updateDocuments, updateIssues, updateWikis };
-    }
-    // 設定ファイルを探索して更新を実行
-    async findAndUpdateSettings(targetDir, flags) {
-        // 現在のディレクトリに設定ファイルがあるか確認
-        const settingsPath = getSettingsFilePath(targetDir);
-        let hasSettings = false;
-        try {
-            await access(settingsPath);
-            hasSettings = true;
-        }
-        catch {
-            // 設定ファイルが存在しない場合は何もしない
-        }
-        if (hasSettings) {
-            // 設定ファイルが存在する場合は更新を実行
-            await this.updateDirectory(targetDir, flags);
-        }
-        // サブディレクトリを探索
-        try {
-            const entries = await readdir(targetDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (entry.isDirectory()) {
-                    const subDir = join(targetDir, entry.name);
-                    // eslint-disable-next-line no-await-in-loop
-                    await this.findAndUpdateSettings(subDir, flags);
-                }
-            }
-        }
-        catch {
-            this.warn(`ディレクトリの読み取りに失敗しました: ${targetDir}`);
-        }
-    }
-    // 指定されたディレクトリの更新を実行
-    async updateDirectory(targetDir, flags) {
-        // 設定ファイルを読み込む
-        const settings = await loadSettings(targetDir);
-        // コマンドライン引数と設定ファイルを組み合わせて使用する値を決定
-        const domain = flags.domain || settings.domain;
-        const projectIdOrKey = flags.projectIdOrKey || settings.projectIdOrKey;
-        const { folderType } = settings;
-        const { documentsOnly, force, issuesOnly, wikisOnly } = flags;
-        // 設定ファイルからオプションを読み込み、コマンドライン引数で上書き
-        const issueKeyFileName = flags.issueKeyFileName ?? settings.issueKeyFileName ?? false;
-        const issueKeyFolder = flags.issueKeyFolder ?? settings.issueKeyFolder ?? false;
-        // 必須パラメータの検証
-        if (!domain) {
-            this.warn(`${targetDir}: ドメインが指定されていません。スキップします。`);
-            return;
-        }
-        if (!projectIdOrKey) {
-            this.warn(`${targetDir}: プロジェクトIDまたはキーが指定されていません。スキップします。`);
-            return;
-        }
-        // APIキーの検証
-        let apiKey;
-        try {
-            apiKey = flags.apiKey || settings.apiKey || getApiKey(this);
-        }
-        catch {
-            this.warn(`${targetDir}: APIキーが指定されていません。--apiKey フラグまたは BACKLOG_API_KEY 環境変数で設定してください。`);
-            return;
-        }
-        // 更新対象の決定
-        const { updateDocuments, updateIssues, updateWikis } = this.determineUpdateTargets(folderType, documentsOnly, issuesOnly, wikisOnly);
-        // 更新前の確認
-        const confirmed = await this.confirmUpdate({
-            domain,
-            folderType,
-            force: force || false,
-            projectIdOrKey,
-            targetDir,
-            updateDocuments,
-            updateIssues,
-            updateWikis,
-        });
-        if (!confirmed)
-            return;
-        // 出力ディレクトリの作成
-        await createOutputDirectory(targetDir);
-        // プロジェクトキーからプロジェクトIDを取得
-        const projectId = await validateAndGetProjectId(domain, projectIdOrKey, apiKey);
-        this.log(`プロジェクトID: ${projectId} を使用します`);
-        // 課題の更新
-        if (updateIssues) {
-            await this.updateIssues({
-                apiKey,
-                domain,
-                issueKeyFileName,
-                issueKeyFolder,
-                projectId,
-                projectIdOrKey,
-                targetDir,
-            });
-        }
-        // Wikiの更新
-        if (updateWikis) {
-            await this.updateWikis({
-                apiKey,
-                domain,
-                projectIdOrKey,
-                targetDir,
-            });
-        }
-        // ドキュメントの更新
-        if (updateDocuments) {
-            await this.updateDocuments({
-                apiKey,
-                domain,
-                projectId,
-                projectIdOrKey,
-                targetDir,
-            });
-        }
-        this.log(`${targetDir} の更新が完了しました！`);
-    }
-    // ドキュメントの更新
-    async updateDocuments(options) {
-        this.log('ドキュメントの更新を開始します...');
-        // 設定ファイルから前回の更新日時を取得
-        const { lastUpdated } = await loadSettings(options.targetDir);
-        await downloadDocuments(this, {
-            apiKey: options.apiKey,
-            domain: options.domain,
-            lastUpdated,
-            outputDir: options.targetDir,
-            projectId: options.projectId,
-            projectIdOrKey: options.projectIdOrKey,
-        });
-        // 設定ファイルを更新
-        await updateSettings(options.targetDir, {
-            apiKey: options.apiKey,
-            domain: options.domain,
-            folderType: FolderType.DOCUMENT,
-            lastUpdated: new Date().toISOString(),
-            outputDir: options.targetDir,
-            projectIdOrKey: options.projectIdOrKey,
-        });
-        this.log('ドキュメントの更新が完了しました');
-    }
-    // 課題の更新
-    async updateIssues(options) {
-        this.log('課題の更新を開始します...');
-        // 設定ファイルから前回の更新日時を取得
-        const { lastUpdated } = await loadSettings(options.targetDir);
-        await downloadIssues(this, {
-            apiKey: options.apiKey,
-            count: 100,
-            domain: options.domain,
-            issueKeyFileName: options.issueKeyFileName,
-            issueKeyFolder: options.issueKeyFolder,
-            lastUpdated,
-            outputDir: options.targetDir,
-            projectId: options.projectId,
-        });
-        // 設定ファイルを更新
-        await updateSettings(options.targetDir, {
-            apiKey: options.apiKey,
-            domain: options.domain,
-            folderType: FolderType.ISSUE,
-            lastUpdated: new Date().toISOString(),
-            outputDir: options.targetDir,
-            projectIdOrKey: options.projectIdOrKey,
-        });
-        this.log('課題の更新が完了しました');
-    }
-    // Wikiの更新
-    async updateWikis(options) {
-        this.log('Wikiの更新を開始します...');
-        // 設定ファイルから前回の更新日時を取得
-        const { lastUpdated } = await loadSettings(options.targetDir);
-        await downloadWikis(this, {
-            apiKey: options.apiKey,
-            domain: options.domain,
-            lastUpdated,
-            outputDir: options.targetDir,
-            projectIdOrKey: options.projectIdOrKey,
-        });
-        // 設定ファイルを更新
-        await updateSettings(options.targetDir, {
-            apiKey: options.apiKey,
-            domain: options.domain,
-            folderType: FolderType.WIKI,
-            lastUpdated: new Date().toISOString(),
-            outputDir: options.targetDir,
-            projectIdOrKey: options.projectIdOrKey,
-        });
-        this.log('Wikiの更新が完了しました');
-    }
 }

package/dist/commands/wiki/index.js

@@ -1,10 +1,12 @@
 import { Command, Flags } from '@oclif/core';
-import * as dotenv from 'dotenv';
-import { downloadWikis } from '../../utils/backlog-api.js';
-import { createOutputDirectory, getApiKey } from '../../utils/common.js';
-import { FolderType, updateSettings } from '../../utils/settings.js';
+import { createBacklogRepositories } from '../../composition/backlog-repositories.js';
+import { FolderType } from '../../modules/settings/domain/settings.js';
+import { updateSettings } from '../../modules/settings/repository/settings-store.js';
+import { exportWikis } from '../../modules/wiki/use-case/export-wikis.js';
+import { API_KEY_NOT_FOUND_MESSAGE, loadDotenv, resolveApiKey } from '../../shared/config/env.js';
+import { ensureDirectory } from '../../shared/storage/markdown-store.js';
 // .envファイルを読み込む
-dotenv.config();
+loadDotenv();
 export default class Wiki extends Command {
     static description = 'Backlogから Wiki を取得してMarkdownファイルとして保存する';
     static examples = [
@@ -38,10 +40,17 @@ Wikiをダウンロードする
         const { flags } = await this.parse(Wiki);
         try {
             const { domain, projectIdOrKey } = flags;
-            const apiKey = flags.apiKey || getApiKey(this);
+            const apiKey = resolveApiKey(flags.apiKey, () => this.log('環境変数 BACKLOG_API_KEY からAPIキーを使用します')) ??
+                this.error(API_KEY_NOT_FOUND_MESSAGE);
             const outputDir = flags.output || './wiki';
+            const logger = { log: (message) => this.log(message), warn: (message) => this.warn(message) };
+            const { wikiRepository } = createBacklogRepositories({
+                apiKey,
+                domain,
+                onRateLimitWait: () => this.log('レート制限を回避するため15秒間待機します...'),
+            });
             // 出力ディレクトリの作成
-            await createOutputDirectory(outputDir);
+            await ensureDirectory(outputDir);
             // 設定ファイルを保存
             await updateSettings(outputDir, {
                 apiKey,
@@ -51,8 +60,7 @@ Wikiをダウンロードする
                 projectIdOrKey,
             });
             // Wikiの取得と保存
-            await downloadWikis(this, {
-                apiKey,
+            await exportWikis({ logger, wikiRepository }, {
                 domain,
                 outputDir,
                 projectIdOrKey,

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

@@ -0,0 +1,16 @@
+import { DocumentRepository } from '../modules/document/domain/document-repository.js';
+import { IssueRepository } from '../modules/issue/domain/issue-repository.js';
+import { ProjectRepository } from '../modules/project/domain/project-repository.js';
+import { WikiRepository } from '../modules/wiki/domain/wiki-repository.js';
+export interface BacklogConnection {
+    apiKey: string;
+    domain: string;
+    onRateLimitWait?: () => void;
+}
+export interface BacklogRepositories {
+    documentRepository: DocumentRepository;
+    issueRepository: IssueRepository;
+    projectRepository: ProjectRepository;
+    wikiRepository: WikiRepository;
+}
+export declare function createBacklogRepositories(connection: BacklogConnection): BacklogRepositories;

package/dist/composition/backlog-repositories.js

@@ -0,0 +1,15 @@
+import { newBacklogDocumentRepository } from '../modules/document/repository/backlog-document-repository.js';
+import { newBacklogIssueRepository } from '../modules/issue/repository/backlog-issue-repository.js';
+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で共有する
+export function createBacklogRepositories(connection) {
+    const client = new BacklogHttpClient(connection);
+    return {
+        documentRepository: newBacklogDocumentRepository(client),
+        issueRepository: newBacklogIssueRepository(client),
+        projectRepository: newBacklogProjectRepository(client),
+        wikiRepository: newBacklogWikiRepository(client),
+    };
+}

package/dist/modules/all/domain/content-selection.d.ts

@@ -0,0 +1,4 @@
+import { ExportTarget } from '../use-case/export-all.js';
+export type ContentSelection = 'both' | 'documents' | 'wiki';
+export declare function parseContentSelection(input: string): ContentSelection;
+export declare function applyContentSelection(targets: ExportTarget[], selection: ContentSelection): ExportTarget[];

package/dist/modules/all/domain/content-selection.js

@@ -0,0 +1,16 @@
+// 空入力・不正入力は「両方」として扱う（従来動作がデフォルト）
+export function parseContentSelection(input) {
+    const normalized = input.trim().toLowerCase();
+    if (normalized === '2' || normalized === 'wiki')
+        return 'wiki';
+    if (normalized === '3' || normalized === 'document' || normalized === 'documents')
+        return 'documents';
+    return 'both';
+}
+export function applyContentSelection(targets, selection) {
+    if (selection === 'wiki')
+        return targets.filter((target) => target !== 'documents');
+    if (selection === 'documents')
+        return targets.filter((target) => target !== 'wiki');
+    return targets;
+}

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

@@ -0,0 +1,24 @@
+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 ExportAllDeps {
+    documentRepository: DocumentRepository;
+    issueRepository: IssueRepository;
+    logger: Logger;
+    projectRepository: ProjectRepository;
+    wikiRepository: WikiRepository;
+}
+export type ExportTarget = 'documents' | 'issues' | 'wiki';
+export interface ExportAllOptions {
+    apiKey: string;
+    domain: string;
+    issueKeyFileName?: boolean;
+    issueKeyFolder?: boolean;
+    maxCount: number;
+    outputRoot: string;
+    projectIdOrKey: string;
+    targets: ExportTarget[];
+}
+export declare function exportAll(deps: ExportAllDeps, options: ExportAllOptions): Promise<void>;

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

@@ -0,0 +1,78 @@
+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, 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,
+            folderType: FolderType.ISSUE,
+            issueKeyFileName,
+            issueKeyFolder,
+            outputDir: issueOutput,
+            projectIdOrKey,
+        });
+        logger.log('課題の取得を開始します...');
+        await exportIssues({ issueRepository, logger }, {
+            count: maxCount,
+            domain,
+            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,
+            folderType: FolderType.WIKI,
+            outputDir: wikiOutput,
+            projectIdOrKey,
+        });
+        logger.log('Wikiの取得を開始します...');
+        await exportWikis({ logger, wikiRepository }, {
+            domain,
+            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,
+            folderType: FolderType.DOCUMENT,
+            outputDir: documentOutput,
+            projectIdOrKey,
+        });
+        logger.log('ドキュメントの取得を開始します...');
+        await exportDocuments({ documentRepository, logger }, {
+            domain,
+            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): string;

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

@@ -0,0 +1,37 @@
+import { wrapBody } from '../../../shared/markdown/body-marker.js';
+export function buildDocumentMarkdown(documentDetail, backlogDocumentUrl) {
+    // 添付ファイルリストの作成
+    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`;
+        }
+    }
+    // タグリストの作成
+    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,15 @@
+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 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,48 @@
+import path from 'node:path';
+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}`;
+}
+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,6 @@
+import { DocumentDetail, DocumentTree } from './document.js';
+export interface DocumentRepository {
+    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 {};