backlog-exporter 0.7.3 → 1.0.0

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

@@ -0,0 +1,4 @@
+import { wrapBody } from '../../../shared/markdown/body-marker.js';
+export function buildWikiMarkdown(wikiName, backlogWikiUrl, content) {
+    return `# ${wikiName}\n\n[Backlog Wiki Link](${backlogWikiUrl})\n\n${wrapBody(content || '（内容なし）')}`;
+}

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

@@ -0,0 +1,4 @@
+import { ExpectedPaths } from '../../prune/domain/expected-paths.js';
+export declare function wikiRelativePath(wikiName: string): string;
+export declare function wikiUrl(domain: string, wikiId: string): string;
+export declare function buildWikiExpectedPaths(wikiNames: string[]): ExpectedPaths;

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

@@ -0,0 +1,25 @@
+import path from 'node:path';
+import { backlogOrigin } from '../../../shared/backlog-url.js';
+import { sanitizeWikiFileName } from '../../../shared/file-name.js';
+export function wikiRelativePath(wikiName) {
+    return `${sanitizeWikiFileName(wikiName)}.md`;
+}
+export function wikiUrl(domain, wikiId) {
+    return `${backlogOrigin(domain)}/alias/wiki/${wikiId}`;
+}
+// 比較相手のpath.relativeはOS標準の区切り文字を返すため、path.normalizeで揃える（Windows対策）
+export function buildWikiExpectedPaths(wikiNames) {
+    const expectedFiles = new Set();
+    const expectedDirs = new Set();
+    for (const name of wikiNames) {
+        const relativePath = path.normalize(wikiRelativePath(name)).normalize('NFC');
+        expectedFiles.add(relativePath);
+        // "親/子.md" のような名前では親ディレクトリも「あるべきディレクトリ」として登録する
+        let dir = path.dirname(relativePath);
+        while (dir && dir !== '.') {
+            expectedDirs.add(dir.normalize('NFC'));
+            dir = path.dirname(dir);
+        }
+    }
+    return { expectedDirs, expectedFiles };
+}

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

@@ -0,0 +1,5 @@
+import { WikiDetail, WikiSummary } from './wiki.js';
+export interface WikiRepository {
+    fetchDetail(wikiId: string, projectIdOrKey: string): Promise<WikiDetail>;
+    fetchWikis(projectIdOrKey: string): Promise<WikiSummary[]>;
+}

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

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

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

@@ -0,0 +1,10 @@
+export interface WikiSummary {
+    id: string;
+    name: string;
+    updated: string;
+}
+export interface WikiDetail {
+    content?: string;
+    id: string;
+    name: string;
+}

package/dist/modules/wiki/domain/wiki.js

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

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

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

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

@@ -0,0 +1,10 @@
+export function newBacklogWikiRepository(client) {
+    return {
+        async fetchDetail(wikiId, projectIdOrKey) {
+            return client.getJson(`/wikis/${wikiId}`, { projectIdOrKey });
+        },
+        async fetchWikis(projectIdOrKey) {
+            return client.getJson('/wikis', { projectIdOrKey });
+        },
+    };
+}

package/dist/modules/wiki/use-case/export-wikis.d.ts

@@ -0,0 +1,14 @@
+import { Logger } from '../../../shared/ports.js';
+import { WikiRepository } from '../domain/wiki-repository.js';
+export interface ExportWikisDeps {
+    logger: Logger;
+    wikiRepository: WikiRepository;
+}
+export interface ExportWikisOptions {
+    domain: string;
+    lastUpdated?: string;
+    outputDir: string;
+    projectIdOrKey: string;
+    wikiIds?: string[];
+}
+export declare function exportWikis(deps: ExportWikisDeps, options: ExportWikisOptions): Promise<void>;

package/dist/modules/wiki/use-case/export-wikis.js

@@ -0,0 +1,43 @@
+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 { selectWikisToExport } from '../domain/wiki-filter.js';
+import { buildWikiMarkdown } from '../domain/wiki-markdown.js';
+import { wikiRelativePath, wikiUrl } from '../domain/wiki-path.js';
+export async function exportWikis(deps, options) {
+    const { logger, wikiRepository } = deps;
+    logger.log('Wikiの取得を開始します...');
+    logger.log('Wiki一覧を取得しています...');
+    const allWikis = await wikiRepository.fetchWikis(options.projectIdOrKey);
+    logger.log(`${allWikis.length}件のWikiが見つかりました。`);
+    const { reason, wikis } = selectWikisToExport(allWikis, options);
+    if (reason === 'ids') {
+        logger.log(`指定された${wikis.length}件のWikiを処理します。`);
+    }
+    else if (reason === 'updatedSince') {
+        logger.log(`前回の更新日時(${options.lastUpdated})以降に更新された${wikis.length}件のWikiを処理します。`);
+    }
+    if (wikis.length === 0) {
+        logger.log('更新が必要なWikiはありません。');
+        return;
+    }
+    logger.log('Wiki詳細を取得しています...');
+    /* eslint-disable no-await-in-loop */
+    for (const [index, wiki] of wikis.entries()) {
+        try {
+            writeProgress(`Wikiを取得中... (${index + 1}/${wikis.length}件)`);
+            const wikiDetail = await wikiRepository.fetchDetail(wiki.id, options.projectIdOrKey);
+            const filePath = path.join(options.outputDir, wikiRelativePath(wiki.name));
+            const backlogWikiUrl = wikiUrl(options.domain, wiki.id);
+            await writeMarkdownFile(filePath, buildWikiMarkdown(wiki.name, backlogWikiUrl, wikiDetail.content || ''));
+            await appendLog(options.outputDir, `Wiki「${wiki.name}」を更新しました: ${backlogWikiUrl}`);
+            writeProgress(`Wikiを保存中... (${index + 1}/${wikis.length}件)`);
+        }
+        catch (error) {
+            logger.warn(`Wiki ${wiki.name} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /* eslint-enable no-await-in-loop */
+    logger.log('\nWikiのダウンロードが完了しました！');
+}

package/dist/shared/backlog/http-client.d.ts

@@ -0,0 +1,17 @@
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, statusText: string, url: string);
+}
+export declare class BacklogHttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly rateLimiter;
+    constructor(options: {
+        apiKey: string;
+        domain: string;
+        onRateLimitWait?: () => void;
+    });
+    getJson<T>(pathname: string, params?: Record<string, string>): Promise<T>;
+    private fetchWithRetry;
+    private maskApiKey;
+}

package/dist/shared/backlog/http-client.js

@@ -0,0 +1,62 @@
+import { backlogOrigin } from '../backlog-url.js';
+import { RateLimiter, sleep } from './rate-limiter.js';
+// fetchは4xx/5xxでthrowしないため、response.okでない場合にこれを投げる
+export class HttpError extends Error {
+    status;
+    constructor(status, statusText, url) {
+        super(`HTTP ${status} ${statusText}: GET ${url}`);
+        this.status = status;
+        this.name = 'HttpError';
+    }
+}
+const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+const MAX_RETRIES = 2;
+const RETRY_BASE_DELAY_MS = 300;
+// apiKey付与・レート制限(100req/15s)・一時エラーのリトライを担うBacklog APIクライアント
+export class BacklogHttpClient {
+    apiKey;
+    baseUrl;
+    rateLimiter;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = `${backlogOrigin(options.domain)}/api/v2`;
+        this.rateLimiter = new RateLimiter(options.onRateLimitWait);
+    }
+    async getJson(pathname, params = {}) {
+        await this.rateLimiter.increment();
+        const searchParams = new URLSearchParams({ apiKey: this.apiKey, ...params });
+        const url = `${this.baseUrl}${pathname}?${searchParams.toString()}`;
+        const response = await this.fetchWithRetry(url);
+        return (await response.json());
+    }
+    // リトライのため、ループ内のawaitは意図したもの
+    /* eslint-disable no-await-in-loop */
+    async fetchWithRetry(url) {
+        for (let attempt = 0;; attempt++) {
+            let response;
+            try {
+                response = await fetch(url);
+            }
+            catch (error) {
+                // ネットワークエラー
+                if (attempt < MAX_RETRIES) {
+                    await sleep(RETRY_BASE_DELAY_MS * 2 ** attempt);
+                    continue;
+                }
+                throw error;
+            }
+            if (response.ok) {
+                return response;
+            }
+            if (attempt < MAX_RETRIES && RETRYABLE_STATUSES.has(response.status)) {
+                await sleep(RETRY_BASE_DELAY_MS * 2 ** attempt);
+                continue;
+            }
+            throw new HttpError(response.status, response.statusText, this.maskApiKey(url));
+        }
+    }
+    /* eslint-enable no-await-in-loop */
+    maskApiKey(url) {
+        return url.replace(/apiKey=[^&]*/, 'apiKey=***');
+    }
+}

package/dist/shared/backlog/rate-limiter.d.ts

@@ -0,0 +1,9 @@
+export declare const sleep: (ms: number) => Promise<void>;
+export declare class RateLimiter {
+    private readonly onWait?;
+    private requestCount;
+    constructor(onWait?: () => void);
+    getCount(): number;
+    increment(): Promise<number>;
+    setCount(count: number): void;
+}

package/dist/shared/backlog/rate-limiter.js

@@ -0,0 +1,25 @@
+export const sleep = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+// Backlogのレート制限(100req/15s)対策: 100リクエストごとに15秒待機する
+export class RateLimiter {
+    onWait;
+    requestCount = 0;
+    constructor(onWait) {
+        this.onWait = onWait;
+    }
+    getCount() {
+        return this.requestCount;
+    }
+    async increment() {
+        this.requestCount++;
+        if (this.requestCount > 1 && this.requestCount % 100 === 0) {
+            this.onWait?.();
+            await sleep(15_000);
+        }
+        return this.requestCount;
+    }
+    setCount(count) {
+        this.requestCount = count;
+    }
+}

package/dist/shared/backlog-url.d.ts

@@ -0,0 +1 @@
+export declare function backlogOrigin(domain: string): string;

package/dist/shared/backlog-url.js

@@ -0,0 +1,5 @@
+// 通常はBacklogドメイン（example.backlog.jp）を https:// として扱う。
+// テストのモックサーバやセルフホスト向けにプロトコル付き（http://127.0.0.1:8080 等）も許可する
+export function backlogOrigin(domain) {
+    return /^https?:\/\//.test(domain) ? domain : `https://${domain}`;
+}

package/dist/shared/config/env.d.ts

@@ -0,0 +1,3 @@
+export declare function loadDotenv(): void;
+export declare function resolveApiKey(provided?: string, onEnvUsed?: () => void): string | undefined;
+export declare const API_KEY_NOT_FOUND_MESSAGE = "API\u30AD\u30FC\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002--apiKey \u30D5\u30E9\u30B0\u307E\u305F\u306F BACKLOG_API_KEY \u74B0\u5883\u5909\u6570\u3067\u63D0\u4F9B\u3057\u3066\u304F\u3060\u3055\u3044";

package/dist/shared/config/env.js

@@ -0,0 +1,21 @@
+import process from 'node:process';
+export function loadDotenv() {
+    try {
+        process.loadEnvFile();
+    }
+    catch {
+        // .env が存在しない場合は何もしない
+    }
+}
+export function resolveApiKey(provided, onEnvUsed) {
+    if (provided) {
+        return provided;
+    }
+    const envApiKey = process.env.BACKLOG_API_KEY;
+    if (envApiKey) {
+        onEnvUsed?.();
+        return envApiKey;
+    }
+    return undefined;
+}
+export const API_KEY_NOT_FOUND_MESSAGE = 'APIキーが見つかりません。--apiKey フラグまたは BACKLOG_API_KEY 環境変数で提供してください';

package/dist/shared/console/progress.d.ts

@@ -0,0 +1 @@
+export declare function writeProgress(message: string): void;

package/dist/shared/console/progress.js

@@ -0,0 +1,4 @@
+import process from 'node:process';
+export function writeProgress(message) {
+    process.stdout.write(`\r${message}`);
+}

package/dist/shared/console/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare function isInteractiveStdin(): boolean;
+export declare function readLine(): Promise<string>;
+export declare function readYesNo(): Promise<boolean>;

package/dist/shared/console/prompt.js

@@ -0,0 +1,19 @@
+import process from 'node:process';
+// 非対話環境では'data'イベントが発火せず確認プロンプトが永久に待機するため、表示前に必ず確認する
+export function isInteractiveStdin() {
+    return Boolean(process.stdin.isTTY);
+}
+export async function readLine() {
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    return new Promise((resolve) => {
+        process.stdin.once('data', (data) => {
+            resolve(data.toString().trim());
+            process.stdin.pause();
+        });
+    });
+}
+export async function readYesNo() {
+    const input = (await readLine()).toLowerCase();
+    return input === 'y' || input === 'yes';
+}

package/dist/shared/file-name.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeFileName(name: string): string;
+export declare function sanitizeWikiFileName(name: string): string;

package/dist/shared/file-name.js

@@ -0,0 +1,15 @@
+export function sanitizeFileName(name) {
+    return name
+        .replaceAll(/[\\/:*?"<>|]/g, '_') // Windowsで使用できない文字を置換
+        .replaceAll(/\s+/g, '_') // スペースをアンダースコアに置換
+        .replaceAll('.', '_') // ドットを置換
+        .slice(0, 200); // 長すぎるファイル名を防ぐために200文字に制限
+}
+export function sanitizeWikiFileName(name) {
+    const invalidChars = ['\\', ':', '*', '?', '"', '<', '>', '|'];
+    let sanitizedName = name;
+    for (const char of invalidChars) {
+        sanitizedName = sanitizedName.replaceAll(char, '_');
+    }
+    return sanitizedName;
+}

package/dist/shared/markdown/body-marker.d.ts

@@ -0,0 +1,3 @@
+export declare const BODY_START_MARKER = "<!-- backlog-exporter:body:start -->";
+export declare const BODY_END_MARKER = "<!-- backlog-exporter:body:end -->";
+export declare function wrapBody(body: string): string;

package/dist/shared/markdown/body-marker.js

@@ -0,0 +1,5 @@
+export const BODY_START_MARKER = '<!-- backlog-exporter:body:start -->';
+export const BODY_END_MARKER = '<!-- backlog-exporter:body:end -->';
+export function wrapBody(body) {
+    return `${BODY_START_MARKER}\n${body}\n${BODY_END_MARKER}`;
+}

package/dist/shared/ports.d.ts

@@ -0,0 +1,4 @@
+export interface Logger {
+    log(message: string): void;
+    warn(message: string): void;
+}

package/dist/shared/ports.js

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

package/dist/shared/storage/markdown-store.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDirectory(directory: string): Promise<void>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function writeMarkdownFile(filePath: string, content: string): Promise<void>;
+export declare function deleteFile(filePath: string): Promise<void>;
+export declare function assertDirectoryExists(directory: string): Promise<void>;

package/dist/shared/storage/markdown-store.js

@@ -0,0 +1,21 @@
+import * as fs from 'node:fs/promises';
+import path from 'node:path';
+export async function ensureDirectory(directory) {
+    await fs.mkdir(directory, { recursive: true });
+}
+export async function fileExists(filePath) {
+    return fs.access(filePath).then(() => true, () => false);
+}
+export async function writeMarkdownFile(filePath, content) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content);
+}
+export async function deleteFile(filePath) {
+    await fs.unlink(filePath);
+}
+export async function assertDirectoryExists(directory) {
+    const stats = await fs.stat(directory).catch(() => { });
+    if (!stats?.isDirectory()) {
+        throw new Error(`指定されたディレクトリが存在しません: ${directory}`);
+    }
+}

package/dist/shared/storage/update-log.d.ts

@@ -0,0 +1 @@
+export declare function appendLog(outputDir: string, message: string): Promise<void>;

package/dist/{utils/log.js → shared/storage/update-log.js}

@@ -1,10 +1,6 @@
 import * as fs from 'node:fs/promises';
 import path from 'node:path';
-/**
- * 更新ログを記録する
- * @param outputDir 出力ディレクトリ
- * @param message ログメッセージ
- */
+// backlog-update.logは監査用途のため、実行環境のロケールに依存せず日本語固定とする
 export async function appendLog(outputDir, message) {
     const logPath = path.join(outputDir, 'backlog-update.log');
     const timestamp = new Date().toLocaleString('ja-JP');

package/oclif.manifest.json

@@ -105,6 +105,74 @@
         "index.js"
       ]
     },
+    "document": {
+      "aliases": [],
+      "args": {},
+      "description": "Backlogからドキュメントを取得してMarkdownファイルとして保存する",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY\nドキュメントをMarkdownファイルとして保存する\n",
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-documents\n指定したディレクトリにドキュメントを保存する\n",
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --keyword 仕様書\nキーワード「仕様書」を含むドキュメントのみを取得する\n"
+      ],
+      "flags": {
+        "apiKey": {
+          "description": "Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)",
+          "name": "apiKey",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "domain": {
+          "description": "Backlog domain (e.g. example.backlog.jp)",
+          "name": "domain",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "keyword": {
+          "description": "検索キーワード",
+          "name": "keyword",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "出力ディレクトリパス",
+          "name": "output",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "projectIdOrKey": {
+          "description": "Backlog project ID or key",
+          "name": "projectIdOrKey",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "document",
+      "pluginAlias": "backlog-exporter",
+      "pluginName": "backlog-exporter",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "document",
+        "index.js"
+      ]
+    },
     "issue": {
       "aliases": [],
       "args": {},
@@ -201,14 +269,20 @@
         "index.js"
       ]
     },
-    "document": {
+    "prune": {
       "aliases": [],
-      "args": {},
-      "description": "Backlogからドキュメントを取得してMarkdownファイルとして保存する",
+      "args": {
+        "directory": {
+          "description": "対象ディレクトリ（設定ファイルが保存されている場所）",
+          "name": "directory",
+          "required": false
+        }
+      },
+      "description": "Backlog上で削除・移動された課題・ドキュメント・Wikiのローカルファイルを削除し、Backlogと同じ状態に揃える",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY\nドキュメントをMarkdownファイルとして保存する\n",
-        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-documents\n指定したディレクトリにドキュメントを保存する\n",
-        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --keyword 仕様書\nキーワード「仕様書」を含むドキュメントのみを取得する\n"
+        "<%= config.bin %> <%= command.id %>\nカレントディレクトリ配下の設定ファイルを探索し、Backlog上に存在しないドキュメントファイルを削除する\n",
+        "<%= config.bin %> <%= command.id %> ./backlog-documents\n指定したディレクトリを対象にする\n",
+        "<%= config.bin %> <%= command.id %> --force\n確認プロンプトをスキップして削除する\n"
       ],
       "flags": {
         "apiKey": {
@@ -222,32 +296,23 @@
         "domain": {
           "description": "Backlog domain (e.g. example.backlog.jp)",
           "name": "domain",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "keyword": {
-          "description": "検索キーワード",
-          "name": "keyword",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "出力ディレクトリパス",
-          "name": "output",
+        "force": {
+          "char": "f",
+          "description": "確認プロンプトをスキップする",
+          "name": "force",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         },
         "projectIdOrKey": {
           "description": "Backlog project ID or key",
           "name": "projectIdOrKey",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -255,7 +320,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document",
+      "id": "prune",
       "pluginAlias": "backlog-exporter",
       "pluginName": "backlog-exporter",
       "pluginType": "core",
@@ -265,7 +330,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "document",
+        "prune",
         "index.js"
       ]
     },
@@ -286,7 +351,10 @@
         "<%= config.bin %> <%= command.id %> ./my-project\n指定したディレクトリの設定を使用して更新する\n",
         "<%= config.bin %> <%= command.id %> --issueKeyFileName\nファイル名を課題キーにする\n",
         "<%= config.bin %> <%= command.id %> --issueKeyFolder\n課題キーでフォルダを作成する\n",
-        "<%= config.bin %> <%= command.id %> --issueKeyFileName --issueKeyFolder\n課題キーでフォルダを作成し、ファイル名も課題キーにする\n"
+        "<%= config.bin %> <%= command.id %> --issueKeyFileName --issueKeyFolder\n課題キーでフォルダを作成し、ファイル名も課題キーにする\n",
+        "<%= config.bin %> <%= command.id %> --issueIdOrKey PROJECT-1,PROJECT-2\n指定した課題（IDまたはキー）のみを再取得する（全件差分更新は行わない）\n",
+        "<%= config.bin %> <%= command.id %> --wikiId 12345,12346\n指定したWiki（ID）のみを再取得する（全件差分更新は行わない）\n",
+        "<%= config.bin %> <%= command.id %> --documentId abc123,def456\n指定したドキュメント（ID）のみを再取得する（全件差分更新は行わない）\n"
       ],
       "flags": {
         "apiKey": {
@@ -297,6 +365,14 @@
           "multiple": false,
           "type": "option"
         },
+        "documentId": {
+          "description": "指定したドキュメント（ID）のみを再取得する（カンマ区切りで複数指定可能）",
+          "name": "documentId",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "documentsOnly": {
           "description": "ドキュメントのみを更新する",
           "name": "documentsOnly",
@@ -320,6 +396,14 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "issueIdOrKey": {
+          "description": "指定した課題（IDまたはキー）のみを再取得する（カンマ区切りで複数指定可能）",
+          "name": "issueIdOrKey",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "issueKeyFileName": {
           "description": "ファイル名を課題キーにする",
           "name": "issueKeyFileName",
@@ -349,6 +433,14 @@
           "multiple": false,
           "type": "option"
         },
+        "wikiId": {
+          "description": "指定したWiki（ID）のみを再取得する（カンマ区切りで複数指定可能）",
+          "name": "wikiId",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "wikisOnly": {
           "description": "Wikiのみを更新する",
           "name": "wikisOnly",
@@ -433,5 +525,5 @@
       ]
     }
   },
-  "version": "0.7.3"
+  "version": "1.0.0"
 }