Skip to content

armgit / ECC

Public Imported from GitHub
0

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.json
index 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.json
index 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.js
index 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.js
index 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.js
index 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.js
index 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'
);
}