The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat(installer): add --locale flag for translated docs installation
Claude71aedad8892d
diff --git a/manifests/install-components.json b/manifests/install-components.jsonindex 585e7f615..039d55cfd 100644--- a/manifests/install-components.json+++ b/manifests/install-components.json@@ -525,6 +525,70 @@"modules": ["machine-learning"]+ },+ {+ "id": "locale:ja",+ "family": "locale",+ "description": "Japanese (ja-JP) translated reference docs installed to ~/.claude/docs/ja-JP/.",+ "modules": [+ "docs-ja-JP"+ ]+ },+ {+ "id": "locale:zh-CN",+ "family": "locale",+ "description": "Simplified Chinese (zh-CN) translated reference docs installed to ~/.claude/docs/zh-CN/.",+ "modules": [+ "docs-zh-CN"+ ]+ },+ {+ "id": "locale:ko-KR",+ "family": "locale",+ "description": "Korean (ko-KR) translated reference docs installed to ~/.claude/docs/ko-KR/.",+ "modules": [+ "docs-ko-KR"+ ]+ },+ {+ "id": "locale:pt-BR",+ "family": "locale",+ "description": "Brazilian Portuguese (pt-BR) translated reference docs installed to ~/.claude/docs/pt-BR/.",+ "modules": [+ "docs-pt-BR"+ ]+ },+ {+ "id": "locale:ru",+ "family": "locale",+ "description": "Russian (ru) translated reference docs installed to ~/.claude/docs/ru/.",+ "modules": [+ "docs-ru"+ ]+ },+ {+ "id": "locale:tr",+ "family": "locale",+ "description": "Turkish (tr) translated reference docs installed to ~/.claude/docs/tr/.",+ "modules": [+ "docs-tr"+ ]+ },+ {+ "id": "locale:vi-VN",+ "family": "locale",+ "description": "Vietnamese (vi-VN) translated reference docs installed to ~/.claude/docs/vi-VN/.",+ "modules": [+ "docs-vi-VN"+ ]+ },+ {+ "id": "locale:zh-TW",+ "family": "locale",+ "description": "Traditional Chinese (zh-TW) translated reference docs installed to ~/.claude/docs/zh-TW/.",+ "modules": [+ "docs-zh-TW"+ ]}]}diff --git a/manifests/install-modules.json b/manifests/install-modules.jsonindex 3244a644f..4cf7e7098 100644--- a/manifests/install-modules.json+++ b/manifests/install-modules.json@@ -693,6 +693,126 @@"defaultInstall": false,"cost": "medium","stability": "stable"+ },+ {+ "id": "docs-ja-JP",+ "kind": "docs",+ "description": "Japanese (ja-JP) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/ja-JP"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-zh-CN",+ "kind": "docs",+ "description": "Simplified Chinese (zh-CN) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/zh-CN"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-ko-KR",+ "kind": "docs",+ "description": "Korean (ko-KR) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/ko-KR"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-pt-BR",+ "kind": "docs",+ "description": "Brazilian Portuguese (pt-BR) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/pt-BR"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-ru",+ "kind": "docs",+ "description": "Russian (ru) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/ru"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-tr",+ "kind": "docs",+ "description": "Turkish (tr) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/tr"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-vi-VN",+ "kind": "docs",+ "description": "Vietnamese (vi-VN) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/vi-VN"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"+ },+ {+ "id": "docs-zh-TW",+ "kind": "docs",+ "description": "Traditional Chinese (zh-TW) translated reference docs for agents, commands, skills, and rules.",+ "paths": [+ "docs/zh-TW"+ ],+ "targets": [+ "claude"+ ],+ "dependencies": [],+ "defaultInstall": false,+ "cost": "heavy",+ "stability": "stable"}]}diff --git a/scripts/install-apply.js b/scripts/install-apply.jsindex 9c3cff1c6..eb48bb06e 100755--- a/scripts/install-apply.js+++ b/scripts/install-apply.js@@ -10,6 +10,7 @@ const os = require('os');const {SUPPORTED_INSTALL_TARGETS,listLegacyCompatibilityLanguages,+ listSupportedLocales,} = require('./lib/install-manifests');const {LEGACY_INSTALL_TARGETS,@@ -19,12 +20,14 @@ const {function getHelpText() {const languages = listLegacyCompatibilityLanguages();+ const locales = listSupportedLocales();return `Usage: install.sh [--target <${LEGACY_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] <language> [<language> ...]install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --profile <name> [--with <component>]... [--without <component>]...install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --modules <id,id,...> [--with <component>]... [--without <component>]...install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --skills <skill-id[,skill-id...]>+ install.sh [--target claude] [--dry-run] [--json] --locale <locale-code>install.sh [--dry-run] [--json] --config <path>Targets:@@ -46,6 +49,8 @@ Options:--skills <ids> Install one or more skill directories by ID, e.g. continuous-learning-v2--without <component>Exclude a user-facing install component+ --locale <code> Install translated docs to ~/.claude/docs/<locale>/+ (claude target only; can be combined with --profile or --with)--config <path> Load install intent from ecc-install.json--dry-run Show the install plan without copying files--json Emit machine-readable plan/result JSON@@ -53,6 +58,9 @@ Options:Available languages:${languages.map(language => ` - ${language}`).join('\n')}++Available locales (--locale):+${locales.map(locale => ` - ${locale}`).join('\n')}`;}diff --git a/scripts/lib/install-manifests.js b/scripts/lib/install-manifests.jsindex ad5ecccd0..14e6769b6 100644--- a/scripts/lib/install-manifests.js+++ b/scripts/lib/install-manifests.js@@ -12,7 +12,28 @@ const COMPONENT_FAMILY_PREFIXES = {capability: 'capability:',agent: 'agent:',skill: 'skill:',+ locale: 'locale:',};+const SUPPORTED_LOCALES = Object.freeze(['ja', 'zh-CN', 'ko-KR', 'pt-BR', 'ru', 'tr', 'vi-VN', 'zh-TW']);+const LOCALE_ALIAS_TO_COMPONENT_ID = Object.freeze({+ 'ja': 'locale:ja',+ 'ja-JP': 'locale:ja',+ 'zh-CN': 'locale:zh-CN',+ 'zh': 'locale:zh-CN',+ 'ko-KR': 'locale:ko-KR',+ 'ko': 'locale:ko-KR',+ 'pt-BR': 'locale:pt-BR',+ 'pt': 'locale:pt-BR',+ 'ru': 'locale:ru',+ 'tr': 'locale:tr',+ 'vi-VN': 'locale:vi-VN',+ 'vi': 'locale:vi-VN',+ 'zh-TW': 'locale:zh-TW',+});++function listSupportedLocales() {+ return [...SUPPORTED_LOCALES];+}const LEGACY_COMPAT_BASE_MODULE_IDS_BY_TARGET = Object.freeze({claude: ['rules-core',@@ -607,11 +628,14 @@ function resolveInstallPlan(options = {}) {module.exports = {DEFAULT_REPO_ROOT,SUPPORTED_INSTALL_TARGETS,+ SUPPORTED_LOCALES,+ LOCALE_ALIAS_TO_COMPONENT_ID,getManifestPaths,loadInstallManifests,getInstallComponent,listInstallComponents,listLegacyCompatibilityLanguages,+ listSupportedLocales,listInstallModules,listInstallProfiles,resolveInstallPlan,diff --git a/scripts/lib/install-targets/claude-home.js b/scripts/lib/install-targets/claude-home.jsindex 230c0b7be..ed5f5f46e 100644--- a/scripts/lib/install-targets/claude-home.js+++ b/scripts/lib/install-targets/claude-home.js@@ -39,6 +39,10 @@ function getClaudeManagedDestinationPath(adapter, sourceRelativePath, input) {);}+ if (normalizedSourcePath === 'docs' || normalizedSourcePath.startsWith('docs/')) {+ return path.join(targetRoot, normalizedSourcePath);+ }+return null;}diff --git a/scripts/lib/install/request.js b/scripts/lib/install/request.jsindex d2a8ef28c..52a79e1ea 100644--- a/scripts/lib/install/request.js+++ b/scripts/lib/install/request.js@@ -1,6 +1,6 @@'use strict';-const { validateInstallModuleIds } = require('../install-manifests');+const { validateInstallModuleIds, LOCALE_ALIAS_TO_COMPONENT_ID, listSupportedLocales } = require('../install-manifests');const LEGACY_INSTALL_TARGETS = ['claude', 'cursor', 'antigravity'];@@ -27,6 +27,7 @@ function parseInstallArgs(argv) {includeComponentIds: [],excludeComponentIds: [],languages: [],+ locale: null,};for (let index = 0; index < args.length; index += 1) {@@ -60,6 +61,9 @@ function parseInstallArgs(argv) {parsed.excludeComponentIds.push(componentId.trim());}index += 1;+ } else if (arg === '--locale') {+ parsed.locale = args[index + 1] || null;+ index += 1;} else if (arg === '--dry-run') {parsed.dryRun = true;} else if (arg === '--json') {@@ -84,9 +88,17 @@ function normalizeInstallRequest(options = {}) {const moduleIds = validateInstallModuleIds(dedupeStrings([...(config?.moduleIds || []), ...(options.moduleIds || [])]));+ const locale = options.locale || config?.locale || null;+ const localeComponentId = locale ? LOCALE_ALIAS_TO_COMPONENT_ID[locale] : null;+ if (locale && !localeComponentId) {+ throw new Error(+ `Unsupported locale: "${locale}". Supported locales: ${listSupportedLocales().join(', ')}`+ );+ }const includeComponentIds = dedupeStrings([...(config?.includeComponentIds || []),...(options.includeComponentIds || []),+ ...(localeComponentId ? [localeComponentId] : []),]);const excludeComponentIds = dedupeStrings([...(config?.excludeComponentIds || []),@@ -102,7 +114,7 @@ function normalizeInstallRequest(options = {}) {if (usingManifestMode && legacyLanguages.length > 0) {throw new Error(- 'Legacy language arguments cannot be combined with --profile, --modules, --with, --without, or manifest config selections'+ 'Legacy language arguments cannot be combined with --profile, --modules, --with, --without, --locale, or manifest config selections');}