@shirokuma-library/shirokuma-docs 0.1.0-alpha.5

package/dist/validators/markdown-structure.js

@@ -0,0 +1,253 @@
+/**
+ * Markdown Structure Validator
+ *
+ * Markdown ドキュメントの構造を検証
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parseFrontmatter, validateFrontmatterField } from "./frontmatter.js";
+import { extractLinks, validateInternalLink } from "./link-checker.js";
+/**
+ * 空の検証結果を作成
+ */
+function createEmptyResult() {
+    return {
+        valid: true,
+        errors: [],
+        warnings: [],
+        infos: [],
+    };
+}
+/**
+ * ファイル存在チェック
+ */
+export function checkFileExists(filePath) {
+    const result = createEmptyResult();
+    if (!existsSync(filePath)) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `File not found: ${filePath}`,
+            file: filePath,
+            rule: "file-exists",
+        });
+    }
+    return result;
+}
+/**
+ * セクション構造チェック
+ */
+export function checkSections(content, rules, filePath) {
+    const result = createEmptyResult();
+    const lines = content.split("\n");
+    for (const rule of rules) {
+        const pattern = new RegExp(rule.pattern, "m");
+        const found = lines.some((line) => pattern.test(line));
+        if (!found) {
+            if (rule.required) {
+                result.valid = false;
+                result.errors.push({
+                    type: "error",
+                    message: `Missing required section: ${rule.description} (pattern: ${rule.pattern})`,
+                    file: filePath,
+                    rule: "section-required",
+                });
+            }
+            else {
+                result.warnings.push({
+                    type: "warning",
+                    message: `Missing optional section: ${rule.description} (pattern: ${rule.pattern})`,
+                    file: filePath,
+                    rule: "section-optional",
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * ドキュメント長さチェック
+ */
+export function checkDocumentLength(content, lengthRule, filePath) {
+    const result = createEmptyResult();
+    const lineCount = content.split("\n").length;
+    if (lengthRule.minLength !== undefined && lineCount < lengthRule.minLength) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `Document too short: ${lineCount} lines (minimum: ${lengthRule.minLength})`,
+            file: filePath,
+            rule: "min-length",
+        });
+    }
+    if (lengthRule.maxLength !== undefined && lineCount > lengthRule.maxLength) {
+        result.warnings.push({
+            type: "warning",
+            message: `Document too long: ${lineCount} lines (maximum: ${lengthRule.maxLength})`,
+            file: filePath,
+            rule: "max-length",
+        });
+    }
+    return result;
+}
+/**
+ * フロントマターチェック
+ */
+export function checkFrontmatter(content, rules, filePath) {
+    const result = createEmptyResult();
+    const parsed = parseFrontmatter(content);
+    // フロントマターが必須だが存在しない場合
+    if (rules.required && !parsed.hasFrontmatter) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: "Required frontmatter is missing",
+            file: filePath,
+            rule: "frontmatter-required",
+        });
+        return result;
+    }
+    // フロントマターがない場合はここで終了
+    if (!parsed.hasFrontmatter || !parsed.data) {
+        return result;
+    }
+    // 解析エラーがある場合
+    if (parsed.parseError) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `Failed to parse frontmatter: ${parsed.parseError}`,
+            file: filePath,
+            rule: "frontmatter-parse",
+        });
+        return result;
+    }
+    // フィールド検証
+    for (const field of rules.fields) {
+        const fieldResult = validateFrontmatterField(parsed.data, field);
+        if (!fieldResult.valid && fieldResult.error) {
+            result.valid = false;
+            result.errors.push({
+                type: "error",
+                message: fieldResult.error,
+                file: filePath,
+                rule: "frontmatter-field",
+            });
+        }
+    }
+    return result;
+}
+/**
+ * 内部リンクチェック
+ */
+export function checkInternalLinks(content, basePath, filePath) {
+    const result = createEmptyResult();
+    const links = extractLinks(content);
+    for (const link of links) {
+        const linkResult = validateInternalLink(link, basePath, filePath);
+        if (!linkResult.valid && linkResult.error) {
+            result.valid = false;
+            result.errors.push({
+                type: "error",
+                message: linkResult.error,
+                file: filePath,
+                line: link.line,
+                rule: "internal-link",
+            });
+        }
+    }
+    return result;
+}
+/**
+ * ファイルパターンチェック
+ */
+export function checkFilePattern(directory, pattern, options, description) {
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+        infos: [],
+        matchedFiles: [],
+    };
+    if (!existsSync(directory)) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `Directory not found: ${directory}`,
+            file: directory,
+            rule: "directory-exists",
+        });
+        return result;
+    }
+    // 正規表現パターンに変換
+    // [0-9] のような文字クラスはそのまま保持
+    const regexPattern = pattern
+        .replace(/\./g, "\\.")
+        .replace(/\*/g, ".*");
+    const regex = new RegExp(`^${regexPattern}$`);
+    // ディレクトリ内のファイルをスキャン
+    try {
+        const files = readdirSync(directory);
+        for (const file of files) {
+            const fullPath = join(directory, file);
+            if (statSync(fullPath).isFile() && regex.test(file)) {
+                result.matchedFiles.push(fullPath);
+            }
+        }
+    }
+    catch (error) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `Failed to read directory: ${error instanceof Error ? error.message : String(error)}`,
+            file: directory,
+            rule: "directory-read",
+        });
+        return result;
+    }
+    // 最小ファイル数チェック
+    if (options.minCount !== undefined && result.matchedFiles.length < options.minCount) {
+        result.valid = false;
+        result.errors.push({
+            type: "error",
+            message: `${description}: Found ${result.matchedFiles.length} files, minimum required: ${options.minCount}`,
+            file: directory,
+            rule: "min-file-count",
+        });
+    }
+    // 最大ファイル数チェック
+    if (options.maxCount !== undefined && result.matchedFiles.length > options.maxCount) {
+        result.warnings.push({
+            type: "warning",
+            message: `${description}: Found ${result.matchedFiles.length} files, maximum recommended: ${options.maxCount}`,
+            file: directory,
+            rule: "max-file-count",
+        });
+    }
+    return result;
+}
+/**
+ * 検証結果をマージする
+ */
+export function mergeResults(...results) {
+    const merged = createEmptyResult();
+    for (const result of results) {
+        if (!result.valid) {
+            merged.valid = false;
+        }
+        merged.errors.push(...result.errors);
+        merged.warnings.push(...result.warnings);
+        merged.infos.push(...result.infos);
+    }
+    return merged;
+}
+/**
+ * ファイル内容を読み込む
+ */
+export function readFileContent(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    return readFileSync(filePath, "utf-8");
+}
+//# sourceMappingURL=markdown-structure.js.map

package/dist/validators/markdown-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-structure.js","sourceRoot":"","sources":["../../src/validators/markdown-structure.ts"],"names":[],"mappings":"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"}

package/i18n/cli/en.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "i18n-cli-messages",
+  "$description": "CLI message dictionary - English",
+  "commands": {
+    "init": {
+      "description": "Initialize configuration file",
+      "initializingConfig": "Initializing config file: {path}",
+      "success": "Configuration file created: {path}",
+      "exists": "Configuration file already exists",
+      "existsHint": "To install skills/rules: shirokuma-docs init --with-skills",
+      "existsRegenHint": "To regenerate, first delete shirokuma-docs.config.yaml",
+      "installingPlugin": "Installing plugin...",
+      "deployingRules": "Deploying rules...",
+      "installingJaPlugin": "Installing Japanese plugin...",
+      "installingHooksPlugin": "Installing safety hooks plugin...",
+      "jaRulesDeployed": "  Japanese rules: {count} deployed → {dir}",
+      "registeringCache": "Registering in global cache...",
+      "registeringCacheCmd": "  Running: claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "cacheRegistered": "Plugin registered in global cache",
+      "cacheFailed": "Cache registration failed: {message}",
+      "cacheManualHint": "  Run manually: claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "jaCacheRegistered": "Japanese plugin also registered in global cache",
+      "hooksCacheRegistered": "Safety hooks plugin also registered in global cache",
+      "claudeNotFound": "claude CLI not found",
+      "claudeInstallHint": "  Install Claude Code, then register the plugin manually",
+      "setupComplete": "--- Setup Complete ---",
+      "summaryConfig": "✓ Config: shirokuma-docs.config.yaml",
+      "summaryPlugin": "✓ Plugin: {skillCount} skills, {ruleCount} rules",
+      "summaryRules": "✓ Rules deployed: {count} → {dir}",
+      "summaryCache": "✓ Global cache: registered",
+      "summaryLanguage": "✓ Language: {lang} (.claude/settings.json)",
+      "languageSet": "Language set to {lang} in .claude/settings.json",
+      "editConfigHint": "After editing config, generate docs:",
+      "editConfigCmd": "  shirokuma-docs generate",
+      "nextSteps": "--- Next Steps ---",
+      "stepInstallClaude": "{step}. Install Claude Code:",
+      "stepInstallClaudeUrl": "   https://code.claude.com/",
+      "stepRegisterCache": "{step}. Register plugin in global cache:",
+      "stepRegisterCacheFallback": "{step}. Register plugin in global cache (if auto-registration failed):",
+      "stepRegisterCacheCmd": "   claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "stepEditConfig": "{step}. Edit the config file for your project:",
+      "stepEditConfigFile": "   shirokuma-docs.config.yaml",
+      "stepGenerate": "{step}. Generate docs:",
+      "stepGenerateCmd": "   shirokuma-docs generate",
+      "skillsHeader": "--- Key Skills (invoke with /<skill-name>) ---",
+      "skillWorkingOnIssue": "  /working-on-issue #<n>   Start working on an issue (branch + status)",
+      "skillStartingSession": "  /starting-session        Start session (handover + issues)",
+      "skillCommitting": "  /committing-on-issue      Stage and commit + push",
+      "skillCreatingPr": "  /creating-pr-on-issue   Create PR",
+      "skillUpdate": "Update skills: shirokuma-docs update",
+      "skillUpdateNote": "  ※ Skills available in new sessions",
+      "stepManualSetup": "{step}. Configure these manual settings in GitHub:",
+      "stepManualSetupCategories": "   - Create Discussion categories: Handovers, ADR, Knowledge, Research",
+      "stepManualSetupWorkflows": "   - Enable Project workflows: Item closed → Done, PR merged → Done",
+      "stepManualSetupVerify": "   Verify: shirokuma-docs session check --setup",
+      "updatingGitignore": "Updating .gitignore...",
+      "gitignoreUpdated": ".gitignore updated ({count} entries added)",
+      "summaryGitignore": "✓ Gitignore: {count} entries added",
+      "pluginInstallFailed": "Plugin installation failed",
+      "configCreateFailed": "Failed to create config file: {error}"
+    },
+    "session": {
+      "description": "Session management (start, end, check)",
+      "start": {
+        "description": "Start a work session",
+        "success": "Session started",
+        "noHandover": "No previous handover found"
+      },
+      "end": {
+        "description": "End a work session",
+        "success": "Session ended",
+        "handoverSaved": "Handover saved: {url}"
+      },
+      "check": {
+        "description": "Check issue/project consistency"
+      }
+    },
+    "repoPairs": {
+      "description": "Public/Private repo pair management (list, init, status, release)"
+    },
+    "updateSkills": {
+      "description": "Update bundled skills and rules",
+      "upToDate": "Already up to date (v{version})",
+      "updated": "Updated to v{version}",
+      "newSkills": "New skills added: {names}",
+      "removedSkills": "Removed obsolete skills: {names}",
+      "summaryHeader": "--- Results ---",
+      "dryRunNote": "(Dry run - no changes applied)",
+      "cliVersion": "CLI version: {version}",
+      "pluginVersion": "Plugin version: {version}",
+      "skillsSummary": "Skills: {details}",
+      "rulesSummary": "Rules: {details}",
+      "deployedRulesSummary": "Deployed rules (.claude/rules/shirokuma/): {details}",
+      "hooksSummary": "Safety hooks: {status}",
+      "hooksUpdated": "updated",
+      "hooksSkipped": "skipped",
+      "hooksError": "error",
+      "completedOk": "Update complete",
+      "completedError": "Update complete ({count} error(s))",
+      "countUpdated": "{count} updated",
+      "countAdded": "{count} added",
+      "countRemoved": "{count} removed",
+      "countSkipped": "{count} skipped",
+      "countUnchanged": "{count} unchanged",
+      "countError": "{count} error(s)",
+      "countDeployed": "{count} new",
+      "errorNoClaudeDir": ".claude directory not found. Run init first.",
+      "errorNoBundledPlugin": "Bundled plugin not found. Please reinstall shirokuma-docs.",
+      "dryRunBanner": "=== Dry run (no changes will be applied) ===\n",
+      "warnVersionMismatch": "CLI version ({cliVersion}) and plugin version ({pluginVersion}) have different major/minor. Consider updating package.json version.",
+      "noInstalledSkills": "No installed skills found.",
+      "installSkillsHint": "To install skills: shirokuma-docs init --with-skills",
+      "newSkillsDetected": "\nNew skills detected: {count}",
+      "obsoleteSkillsDetected": "\nObsolete skills detected: {count}",
+      "updatingSkills": "\nUpdating skills...",
+      "processingObsoleteSkills": "\nProcessing obsolete skills...",
+      "syncModeIncludesRules": "\n--sync mode: also syncing rules",
+      "updatingRules": "\nUpdating rules...",
+      "deployingRules": "\nDeploying rules...",
+      "deployingRulesJa": "\nDeploying rules (Japanese)...",
+      "legacyDirRemoved": "Legacy directory .claude/rules/shirokuma-ja/ removed",
+      "updatingGlobalCache": "\nUpdating global cache...",
+      "globalCacheUpdated": "Global cache updated (takes effect in new sessions)",
+      "jaCacheUpdated": "Japanese plugin cache also updated",
+      "hooksCacheUpdated": "Safety hooks plugin cache also updated",
+      "cacheAutoSyncFailed": "Auto cache sync failed: {reason}",
+      "cacheManualSyncHint": "Please update the global cache manually:",
+      "cacheUninstallCommand": "  claude plugin uninstall {registryId} --scope project",
+      "cacheInstallCommand": "  claude plugin install {registryId} --scope project",
+      "cacheNewSessionNote": "  Note: takes effect in new sessions",
+      "logItemNew": "  + {name} (new)",
+      "logItemLocalChangesSkipped": "  ⊘ {name} (local changes, skipped)",
+      "logItemUnchanged": "  - {name} (unchanged)",
+      "logItemWouldUpdate": "  ↑ {name} (would update)",
+      "logItemUpdated": "  ↑ {name} (updated)",
+      "logItemUpdatedProjectPreserved": "  ↑ {name} (updated, project/ preserved)",
+      "logItemError": "  ✗ {name} (error: {reason})",
+      "logItemRemovedFromBundled": "  ⊘ {name} (removed from bundled, use --yes to delete)",
+      "logItemWouldRemove": "  - {name} (would remove)",
+      "logItemRemoved": "  ✗ {name} (removed)",
+      "logItemRemovalFailed": "  ✗ {name} (removal failed: {reason})"
+    }
+  },
+  "config": {
+    "notFound": "Config file not found: {path}",
+    "usingDefaults": "Using default configuration",
+    "loadFailed": "Failed to load config file: {error}"
+  },
+  "errors": {
+    "configNotFound": "Configuration file not found. Run 'shirokuma-docs init' first.",
+    "ghNotAuthenticated": "GitHub CLI not authenticated. Run 'gh auth login'.",
+    "commandNotFound": "Command not found: {command}",
+    "errorOccurred": "An error occurred: {error}"
+  }
+}

package/i18n/cli/ja.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "i18n-cli-messages",
+  "$description": "CLIメッセージ辞書 - 日本語",
+  "commands": {
+    "init": {
+      "description": "設定ファイルを初期化",
+      "initializingConfig": "設定ファイルを初期化: {path}",
+      "success": "設定ファイルを作成しました: {path}",
+      "exists": "設定ファイルは既に存在します",
+      "existsHint": "スキル/ルールをインストールするには: shirokuma-docs init --with-skills",
+      "existsRegenHint": "設定ファイルを再生成するには、まず shirokuma-docs.config.yaml を削除してください",
+      "installingPlugin": "プラグインをインストール中...",
+      "deployingRules": "ルールをデプロイ中...",
+      "installingJaPlugin": "日本語プラグインをインストール中...",
+      "installingHooksPlugin": "安全フックプラグインをインストール中...",
+      "jaRulesDeployed": "  日本語ルール: {count}件デプロイ → {dir}",
+      "registeringCache": "グローバルキャッシュに登録中...",
+      "registeringCacheCmd": "  実行: claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "cacheRegistered": "プラグインをグローバルキャッシュに登録しました",
+      "cacheFailed": "キャッシュ登録に失敗: {message}",
+      "cacheManualHint": "  手動で実行してください: claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "jaCacheRegistered": "日本語プラグインもグローバルキャッシュに登録しました",
+      "hooksCacheRegistered": "安全フックプラグインもグローバルキャッシュに登録しました",
+      "claudeNotFound": "claude CLI が見つかりません",
+      "claudeInstallHint": "  Claude Code をインストールしてから、プラグインを手動で登録してください",
+      "setupComplete": "--- セットアップ完了 ---",
+      "summaryConfig": "✓ 設定ファイル: shirokuma-docs.config.yaml",
+      "summaryPlugin": "✓ プラグイン: {skillCount} スキル, {ruleCount} ルール",
+      "summaryRules": "✓ ルールデプロイ: {count}個 → {dir}",
+      "summaryCache": "✓ グローバルキャッシュ: 登録済み",
+      "summaryLanguage": "✓ 言語: {lang} (.claude/settings.json)",
+      "languageSet": "言語を {lang} に設定しました (.claude/settings.json)",
+      "editConfigHint": "設定を編集した後、以下のコマンドでドキュメントを生成:",
+      "editConfigCmd": "  shirokuma-docs generate",
+      "nextSteps": "--- 次のステップ ---",
+      "stepInstallClaude": "{step}. Claude Code をインストール:",
+      "stepInstallClaudeUrl": "   https://code.claude.com/",
+      "stepRegisterCache": "{step}. プラグインをグローバルキャッシュに登録:",
+      "stepRegisterCacheFallback": "{step}. プラグインをグローバルキャッシュに登録 (自動登録が失敗した場合):",
+      "stepRegisterCacheCmd": "   claude plugin install shirokuma-skills-en@shirokuma-library --scope project",
+      "stepEditConfig": "{step}. 設定ファイルをプロジェクトに合わせて編集:",
+      "stepEditConfigFile": "   shirokuma-docs.config.yaml",
+      "stepGenerate": "{step}. ドキュメントを生成:",
+      "stepGenerateCmd": "   shirokuma-docs generate",
+      "skillsHeader": "--- 主要スキル（/<skill-name> で実行）---",
+      "skillWorkingOnIssue": "  /working-on-issue #<n>   Issue ベースの作業開始（ブランチ作成 + ステータス管理）",
+      "skillStartingSession": "  /starting-session        セッション開始（引き継ぎ確認 + Issue 一覧）",
+      "skillCommitting": "  /committing-on-issue      変更のコミット + プッシュ",
+      "skillCreatingPr": "  /creating-pr-on-issue   PR 作成",
+      "skillUpdate": "スキル更新: shirokuma-docs update",
+      "skillUpdateNote": "  ※ 新しいセッションでスキルが利用可能になります",
+      "stepManualSetup": "{step}. GitHub で以下の手動設定を行う:",
+      "stepManualSetupCategories": "   - Discussion カテゴリ作成: Handovers, ADR, Knowledge, Research",
+      "stepManualSetupWorkflows": "   - Projects ワークフロー有効化: Item closed → Done, PR merged → Done",
+      "stepManualSetupVerify": "   確認: shirokuma-docs session check --setup",
+      "updatingGitignore": ".gitignore を更新中...",
+      "gitignoreUpdated": ".gitignore を更新しました（{count}件追加）",
+      "summaryGitignore": "✓ Gitignore: {count}件追加",
+      "pluginInstallFailed": "プラグインのインストールに失敗しました",
+      "configCreateFailed": "設定ファイルの作成に失敗: {error}"
+    },
+    "session": {
+      "description": "セッション管理 (start, end, check)",
+      "start": {
+        "description": "作業セッションを開始",
+        "success": "セッションを開始しました",
+        "noHandover": "前回の引き継ぎが見つかりません"
+      },
+      "end": {
+        "description": "作業セッションを終了",
+        "success": "セッションを終了しました",
+        "handoverSaved": "引き継ぎを保存しました: {url}"
+      },
+      "check": {
+        "description": "Issue/Project の整合性をチェック"
+      }
+    },
+    "repoPairs": {
+      "description": "Public/Private リポジトリペア管理 (list, init, status, release)"
+    },
+    "updateSkills": {
+      "description": "バンドルされたスキルとルールを更新",
+      "upToDate": "最新です (v{version})",
+      "updated": "v{version} に更新しました",
+      "newSkills": "新しいスキルが追加されました: {names}",
+      "removedSkills": "廃止されたスキルを削除しました: {names}",
+      "summaryHeader": "--- 結果 ---",
+      "dryRunNote": "(ドライラン - 変更は適用されていません)",
+      "cliVersion": "CLIバージョン: {version}",
+      "pluginVersion": "プラグインバージョン: {version}",
+      "skillsSummary": "スキル: {details}",
+      "rulesSummary": "ルール: {details}",
+      "deployedRulesSummary": "デプロイ済みルール (.claude/rules/shirokuma/): {details}",
+      "hooksSummary": "安全フック: {status}",
+      "hooksUpdated": "更新済み",
+      "hooksSkipped": "スキップ",
+      "hooksError": "エラー",
+      "completedOk": "更新完了",
+      "completedError": "更新完了（{count}件のエラー）",
+      "countUpdated": "{count}件更新",
+      "countAdded": "{count}件追加",
+      "countRemoved": "{count}件削除",
+      "countSkipped": "{count}件スキップ",
+      "countUnchanged": "{count}件変更なし",
+      "countError": "{count}件エラー",
+      "countDeployed": "{count}件新規",
+      "errorNoClaudeDir": ".claude ディレクトリが見つかりません。先に init を実行してください。",
+      "errorNoBundledPlugin": "バンドルプラグインが見つかりません。shirokuma-docs を再インストールしてください。",
+      "dryRunBanner": "=== ドライラン（変更は適用されません）===\n",
+      "warnVersionMismatch": "CLIバージョン ({cliVersion}) とプラグインバージョン ({pluginVersion}) のメジャー/マイナーが異なります。package.json のバージョン更新を検討してください。",
+      "noInstalledSkills": "インストール済みスキルが見つかりません。",
+      "installSkillsHint": "スキルをインストールするには: shirokuma-docs init --with-skills",
+      "newSkillsDetected": "\n新規スキル検出: {count}件",
+      "obsoleteSkillsDetected": "\n削除対象スキル検出: {count}件",
+      "updatingSkills": "\nスキルを更新中...",
+      "processingObsoleteSkills": "\n削除対象スキルを処理中...",
+      "syncModeIncludesRules": "\n--sync モード: ルールも同期します",
+      "updatingRules": "\nルールを更新中...",
+      "deployingRules": "\nルールをデプロイ中...",
+      "deployingRulesJa": "\nルールをデプロイ中（日本語）...",
+      "legacyDirRemoved": "レガシーディレクトリ .claude/rules/shirokuma-ja/ を削除しました",
+      "updatingGlobalCache": "\nグローバルキャッシュを更新中...",
+      "globalCacheUpdated": "グローバルキャッシュを更新しました（新しいセッションで反映されます）",
+      "jaCacheUpdated": "日本語プラグインのキャッシュも更新しました",
+      "hooksCacheUpdated": "安全フックプラグインのキャッシュも更新しました",
+      "cacheAutoSyncFailed": "キャッシュ自動更新に失敗しました: {reason}",
+      "cacheManualSyncHint": "手動でグローバルキャッシュを更新してください:",
+      "cacheUninstallCommand": "  claude plugin uninstall {registryId} --scope project",
+      "cacheInstallCommand": "  claude plugin install {registryId} --scope project",
+      "cacheNewSessionNote": "  ※ 新しいセッションで反映されます",
+      "logItemNew": "  + {name} (new)",
+      "logItemLocalChangesSkipped": "  ⊘ {name} (local changes, skipped)",
+      "logItemUnchanged": "  - {name} (unchanged)",
+      "logItemWouldUpdate": "  ↑ {name} (would update)",
+      "logItemUpdated": "  ↑ {name} (updated)",
+      "logItemUpdatedProjectPreserved": "  ↑ {name} (updated, project/ preserved)",
+      "logItemError": "  ✗ {name} (error: {reason})",
+      "logItemRemovedFromBundled": "  ⊘ {name} (removed from bundled, use --yes to delete)",
+      "logItemWouldRemove": "  - {name} (would remove)",
+      "logItemRemoved": "  ✗ {name} (removed)",
+      "logItemRemovalFailed": "  ✗ {name} (removal failed: {reason})"
+    }
+  },
+  "config": {
+    "notFound": "設定ファイルが見つかりません: {path}",
+    "usingDefaults": "デフォルト設定を使用します",
+    "loadFailed": "設定ファイルの読み込みに失敗: {error}"
+  },
+  "errors": {
+    "configNotFound": "設定ファイルが見つかりません。先に 'shirokuma-docs init' を実行してください。",
+    "ghNotAuthenticated": "GitHub CLI が認証されていません。'gh auth login' を実行してください。",
+    "commandNotFound": "コマンドが見つかりません: {command}",
+    "errorOccurred": "エラーが発生しました: {error}"
+  }
+}