@rch4com/agent-setup 1.1.0 → 1.4.0

package/lib/i18n/catalog/en.mjs

@@ -0,0 +1,369 @@
+// 기준 카탈로그 — 모든 키의 원본이자 폴백이다.
+// ko.mjs는 이 키 집합을 그대로 따라야 한다. 키·자리·타입이 어긋나는 순간
+// i18n.test.mjs가 실패한다.
+//
+// 값은 문자열 또는 문자열 배열(여러 줄)만 쓴다. 함수를 두면 카탈로그가
+// 데이터가 아니게 되어 완전성 검사를 할 수 없다.
+export default {
+  // 언어 이름은 어떤 화면에서 보든 자기 언어로 쓴다 — 두 카탈로그에서 값이 같다.
+  'locale.en': 'English',
+  'locale.ko': '한국어',
+
+  'error.notGitRepo': 'Run this inside a Git repository.',
+  'error.pathOutsideRepo': 'Cannot write outside the repository: {path}',
+  'error.pathUnresolvable': 'Cannot resolve path: {path} ({code})',
+  'error.pathEscapesViaLink': 'This in-repo path escapes through an external link: {path} -> {real}',
+
+  'usage.bootstrap': [
+    'Usage: npx @rch4com/agent-setup bootstrap [--skill-mode auto|link|copy] [--dry-run]',
+    '       node install.mjs bootstrap [options]   # when the installer lives in the repo',
+    '',
+    'Options:',
+    '  --skill-mode auto|link|copy  How skills are wired up. (default: auto)',
+    '                                  auto: try a symlink first, fall back to copying.',
+    '                                  link: symlink only. Exit with an error if it fails.',
+    '                                  copy: always make copies.',
+    '  --adopt                      Create nothing. Record only the existing files that',
+    '                               already match this version of the templates.',
+    '  --lang en|ko                 Display language for this run.',
+    '  --dry-run                    Change nothing; print what would happen.',
+    '  -h, --help                   Print this help and exit.',
+    '',
+    'The launchers work too:',
+    '  ./setup-agents.sh [options]',
+    '  pwsh -File ./setup-agents.ps1 [options]',
+    '  Pass --tui (or -Tui) to install dependencies and open the interactive screen,',
+    '  where bootstrap, agents, and design.md live in one searchable list.',
+  ],
+  'usage.root': [
+    'Usage: npx @rch4com/agent-setup [options]',
+    '       npx @rch4com/agent-setup bootstrap [options]',
+    '       npx @rch4com/agent-setup update [options]',
+    '       npx @rch4com/agent-setup status [options]',
+    '       npx @rch4com/agent-setup design [options]',
+    '',
+    'When the installer lives in the repo, use node install.mjs in place of',
+    'npx @rch4com/agent-setup.',
+    '',
+    'With no options this opens the interactive screen, where bootstrap, agents,',
+    'and design.md live in one searchable list.',
+    '',
+    'Options:',
+    '  --list                       Print the current install state and exit.',
+    '  --set <list>                 Converge on a comma-separated set of items.',
+    '                               Use --set "" to remove everything.',
+    '  --skill-mode auto|link|copy  How the bootstrap launched from the interactive',
+    '                               screen wires up skills. (default: auto)',
+    '  --design-dir <path>          Add a design.md source. Accepts <source-id>=<path>',
+    '                               and may be repeated.',
+    '  --lang en|ko                 Display language for this run.',
+    '  --dry-run                    Change nothing; print what would happen.',
+    '  -h, --help                   Print this help and exit.',
+    '',
+    '--list and --set both choose an action, so they cannot be combined.',
+    '',
+    'Subcommand help: npx @rch4com/agent-setup bootstrap --help',
+    '                 npx @rch4com/agent-setup update --help',
+    '                 npx @rch4com/agent-setup status --help',
+    '                 npx @rch4com/agent-setup design --help',
+  ],
+  'usage.design': [
+    'Usage: npx @rch4com/agent-setup design [options]',
+    '       node install.mjs design [options]   # when the installer lives in the repo',
+    '',
+    'With no options this opens the interactive screen, where the DESIGN.MD tab lives.',
+    '',
+    'Options:',
+    '  --list                 Print the catalog and install state.',
+    '  --set <list>           Converge on a comma-separated set of items.',
+    '                         A token is <name> or <provider>/<name>.',
+    '                         Use --set "" to remove everything.',
+    '  --preview <list>       Open previews.',
+    '  --sync=installed       Refetch installed copies from their sources.',
+    '  --sync=catalog         Rebuild the available list and categories from sources.',
+    '  --sync=stale           Compare installed copies against their sources by hash.',
+    '  --design-dir <path>    Add a design.md source. Accepts <source-id>=<path>',
+    '                         and may be repeated.',
+    '  --lang en|ko           Display language for this run.',
+    '  --dry-run              Change nothing; print what would happen.',
+    '  -h, --help             Print this help and exit.',
+    '',
+    '--list, --set, --preview, and --sync each choose an action, so only one',
+    'may be given at a time.',
+  ],
+  'usage.update': [
+    'Usage: npx @rch4com/agent-setup update [options]',
+    '',
+    'Compares hashes against the install record and refreshes only the managed',
+    'files that are still exactly as we wrote them. Files you edited are left',
+    'alone and reported as drift.',
+    '',
+    'Options:',
+    '  --force      Overwrite drifted files too. The working tree must be clean',
+    '               (git is the only way back).',
+    '  --lang en|ko Display language for this run.',
+    '  --dry-run    Change nothing; print what would happen.',
+    '  -h, --help   Print this help and exit.',
+  ],
+  'usage.status': [
+    'Usage: npx @rch4com/agent-setup status [options]',
+    '',
+    'Shows intent (the install record), reality (a scan of the repository), and',
+    'the running tool version side by side. Changes nothing.',
+    '',
+    'Options:',
+    '  --json       Print machine-readable output (for CI checks).',
+    '  --lang en|ko Display language for this run.',
+    '  -h, --help   Print this help and exit.',
+  ],
+
+  'error.unknownArg': 'Unknown argument: {token}\n\n{usage}',
+  'error.flagTakesNoValue': '{name} takes no value: {token}\n\n{usage}',
+  'error.singleAction': 'Cannot be combined: {given} — give only one action flag at a time.\n\n{usage}',
+  'error.badSkillMode': '--skill-mode must be one of {list}: {value}\n\n{usage}',
+  'error.skillModeNeedsValue': '--skill-mode needs a value ({list}).\n\n{usage}',
+  'error.badLang': '--lang must be one of {list}: {value}\n\n{usage}',
+  'error.langNeedsValue': '--lang needs a value ({list}).\n\n{usage}',
+  'error.needsValue': '{name} needs a value.',
+  'error.setNeedsValue': '--set needs an item list. Use --set "" to remove everything.',
+  'error.badSync': 'Use --sync=installed|catalog|stale.',
+
+  'status.installed': 'Installed',
+  'status.partial': 'Partial',
+  'status.absent': 'Not installed',
+
+  'change.install': 'Install',
+  'change.complete': 'Finish',
+  'change.uninstall': 'Remove',
+
+  'apply.noChanges': 'Nothing to change.',
+  'apply.finalState': 'Final state:',
+  'apply.seeGitDiff': 'Use git diff to review the config changes.',
+  'error.unknownItem': 'Unknown item: {id}',
+
+  'error.depsMissing': [
+    'This feature needs dependencies. Run one of:',
+    '  ./setup-agents.sh --tui',
+    '  npm install --prefix agent-installer',
+  ],
+
+  'log.record.write': 'install record written: {path}',
+  'error.recordUnreadable': 'Cannot read {path} ({code})',
+  'error.recordNotJson': 'Cannot read {path} — not JSON ({message})',
+  'error.recordVersion': '{path} has format version {found}. This tool uses {expected} — upgrade the tool or recreate the record.',
+
+  'log.repoRoot': 'repository root: {path}',
+  'log.noGlobalWrites': 'Global config paths are never read or modified.',
+  'log.dir.create': 'create directory: {path}',
+  'log.file.keep': 'keep existing file: {path}',
+  'log.file.create': 'create file: {path}',
+  'log.file.update': 'update file: {path}',
+  'log.file.userEdited': 'edited by you — left alone: {path}',
+  'log.block.keep': 'managed block present: {path}',
+  'log.block.add': 'add managed block: {path}',
+  'log.block.update': 'update managed block: {path}',
+  'log.block.missing': 'no managed block — left alone: {path}',
+  'log.block.userEdited': 'block edited by you — left alone: {path}',
+  'log.json.keep': 'config key present: {path} — {key}',
+  'log.json.add': 'add config key: {path} — {key}',
+  'log.ignore.keep': '.gitignore entries present: {entries}',
+  'log.ignore.add': 'add .gitignore entries: {entries}',
+  'log.warn.unreadable': 'warning: cannot read {path}, skipping ({code})',
+  'log.warn.noRootObject': 'warning: no root object in {path}, skipping',
+  'log.warn.ignoreShadowed': 'warning: "{parent}" in .gitignore excludes the whole directory, so the "{entry}" negation has no effect. Change it to "{parent}/*" to include it again.',
+  'log.skill.linkOk': '{tool} skill link present: {path}',
+  'log.skill.linkCreate': '{tool} skill link created: {path} -> {target}',
+  'log.skill.copyCreate': '{tool} skill copy created: {path}',
+  'log.skill.copySync': '{tool} skill copy synced: {path}',
+  'log.skill.plan': '{tool} skill adapter to be created: {path} ({mode})',
+  'log.skill.warnForeignLink': 'warning: {path} is a link pointing elsewhere. Leaving it alone.',
+  'log.skill.warnUnmanaged': 'warning: {path} already exists and is not managed by agent-kit. Leaving it alone.',
+  'log.skill.linkFellBack': 'warning: {tool} link creation failed; falling back to copying.',
+
+  'msg.readFailed': 'read failed',
+  'msg.noRootObject': 'no root object',
+  'msg.foreignLink': 'link pointing elsewhere',
+  'msg.unmanagedExisting': 'existing entry not under management',
+  'msg.noManagedBlock': 'no managed block',
+  'msg.linkFailed': 'link creation failed: {message}',
+
+  'bootstrap.failures': '{count} failed:',
+  'bootstrap.done': 'done.',
+  'bootstrap.sharedGuide': 'shared guide: AGENTS.md',
+  'bootstrap.sharedSkills': 'shared skills: .agents/skills/',
+  'bootstrap.tools': 'tools covered: {list}',
+  'bootstrap.repoOnly': 'Every per-tool config was created inside this repository only.',
+  'bootstrap.noOverwrite': 'No existing config file was overwritten.',
+  'bootstrap.record': 'install record: {path}',
+
+  'error.badSkillModeRuntime': '--skill-mode must be one of {list}: {value}',
+
+  // status·update 화면 문구. status.row.*는 표 정렬용 공백을 포함한다 — tool과
+  // items의 값 시작 열이 같아야 한다(status.test.mjs의 열 정렬 테스트가 검증).
+  'status.noRecord': 'No install record.',
+  'status.noRecord.hint1': '  To bring this repository under the record, run bootstrap --adopt.',
+  'status.noRecord.hint2': '  It creates nothing and records only files that match the templates.',
+  'status.row.tool': 'tool                    {version}',
+  'status.version.pinned': '{pinned} pinned · running {running}',
+  'status.version.latest': '{pinned} pinned · running {running} · latest {latest}',
+  'status.hint.update': '                        → update can move the pinned version',
+  'status.row.files': 'managed                 {current} of {total} current · {pending} pending · {drift} edited by you',
+  'status.hint.pending': '                        → update',
+  'status.hint.drift': '                        → update leaves files you edited alone',
+  'status.row.items': 'items       installed   {list}',
+  'status.row.recordOnly': '            record only {list}',
+  'status.row.repoOnly': '            repo only   {list}',
+  'status.none': '(none)',
+  'update.versionMove': 'pinned {pinned} → running {running}',
+  'update.summary': '{updated} updated · {created} created · {drift} drifted',
+  'update.driftHeader': 'drift (left alone)',
+  'update.driftHint': 'run update --force to take the latest templates (the working tree must be clean)',
+  'error.forceNeedsCleanTree': '--force needs a clean working tree. git is the only way back, so overwriting uncommitted changes cannot be undone.',
+  'error.noRecordForUpdate': '{path} does not exist. To bring this repository under the record, run bootstrap --adopt first — it creates nothing and only writes the record.',
+
+  // 항목 카탈로그 — note·unsupported 사유·detect()의 detail은 만들어지는 시점에
+  // 로케일을 모른다. catalog.mjs·lib/items/*가 여기 키를 담아 두고, 표시하는
+  // 쪽이 렌더 시점에 t나 toText로 푼다.
+  'item.unsupported.claudePlugin': 'Claude Code plugin only',
+  'item.unsupported.claudeSkill': 'Claude Code skill install',
+  'item.unsupported.ponytailUser': 'upstream installs it per user (codex/copilot plugin, gemini extension)',
+  'item.unsupported.ponytailRules': 'no plugin mechanism — copy the ruleset into AGENTS.md by hand',
+  'item.mcp.partial': 'registered: {present} / missing: {missing}',
+  'item.plugin.partial': 'wired: {present} / missing: {missing}',
+  'item.plugin.deferred': 'recorded in config — it downloads on the next Claude Code run',
+  'item.scanFailed': 'detection failed: {message}',
+  'log.mcp.add': '  [dry-run] register {name} in the {cli} config',
+  'log.mcp.remove': '  [dry-run] remove {name} from the {cli} config',
+  'log.plugin.add': '  [dry-run] add plugin {name} to the {cli} config',
+  'log.plugin.remove': '  [dry-run] remove plugin {name} from the {cli} config',
+
+  'item.mcp.notion.note': 'auth: OAuth on first use in each CLI',
+  'item.mcp.vercel.note': 'auth: OAuth on first use (only approved clients can connect)',
+  'item.mcp.supabase.note': 'auth: OAuth dynamic registration. Add ?project_ref=<id> to the URL to pin a project',
+  'item.mcp.codebase-memory.note': 'needs the codebase-memory-mcp binary on PATH. Install: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
+  'item.mcp.graphify.note': 'needs the graphify-mcp binary on PATH. Install: uv tool install "graphifyy[mcp]". Reads graphify-out/graph.json — build it first with /graphify .',
+  'item.mcp.headroom.note': 'needs the headroom binary on PATH. Install: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". The proxy (headroom wrap) is a way of launching, not repo config',
+  'item.plugin.superpowers.note': 'official marketplace plugin',
+  'item.plugin.mattpocock-skills.note': '22 engineering and productivity skills (tdd, code-review, research, …)',
+  'item.plugin.ponytail.note': 'lean-code ruleset. Wires the Claude Code plugin and the OpenCode plugin entry, both repo-scoped',
+  'item.plugin.ecc.note': 'skills, instincts, memory and security for agent harnesses. Installed as a plugin — its skills/ holds 281 entries, too many to copy into the shared skills directory',
+  'item.plugin.impeccable.note': 'design language for AI harnesses. Plugin route on purpose: npx impeccable install replaces .claude/skills and breaks the shared .agents/skills link',
+  'item.plugin.understand-anything.note': 'turns the codebase into an explorable knowledge graph. The script for other CLIs clones into ~/.understand-anything (user scope), so only the plugin is wired',
+  'item.skill.caveman.note': 'cuts output tokens by answering in caveman-speak; code and errors stay byte-exact. Toggle with /caveman',
+  'item.skill.taste.note': 'anti-slop frontend skill for landing pages, portfolios and redesigns (skill name: design-taste-frontend)',
+  'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
+  'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally.',
+  'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project',
+  'error.gstackClone': 'gstack clone failed: {output}',
+  'error.gstackSetup': 'gstack setup failed: {output}',
+  'error.gsdInstall': 'GSD install failed: {output}',
+  'error.gsdUninstall': 'GSD uninstall failed: {output}',
+  'error.ponytailOpencodePlugin': '{file}: the plugin key is not an array. Leaving it alone — add "@dietrichgebert/ponytail" by hand.',
+  'error.registrySkillInstall': 'skill registry install failed ({skill}): {output}',
+  'error.itemFieldMissing': '{file}: {field} missing',
+  'error.itemReasonMissing': '{id}: needs a reason for unsupported CLI \'{cli}\' (unsupported.{cli})',
+  'error.shellQuote': 'The argument contains a double quote that cannot be passed to the shell: {value}',
+
+  // TUI 탭 이름. rows.mjs의 SECTION_ORDER id(action·plugin·mcp·skill·design)를
+  // 그대로 따른다 — 탭 순서·검색 스코프는 id로 갈리고, 여기서는 표시만 맡는다.
+  'section.action': 'ACTION',
+  'section.plugin': 'PLUGIN',
+  'section.mcp': 'MCP',
+  'section.skill': 'SKILL',
+  'section.design': 'DESIGN.MD',
+
+  // TUI 목록·검토 화면 문구. item.*는 agentHint가, action.*.label/hint는
+  // buildActions가 쓴다. action.*.label과 section.*는 LABEL_WIDTH(24) 안에
+  // 들어야 한다 — i18n.test.mjs가 검사한다.
+  'tui.counts': 'selected {picked} / {total}',
+  'tui.search.prefix': 'Search › ',
+  'tui.search.placeholder': 'type to search · ↓ for the list',
+  'tui.empty.filtered': '  Nothing matches in this tab. Press Tab to try another.',
+  'tui.empty.none': '  Nothing here.',
+  'tui.hint.search': 'type to search (spaces included)   ↓ to list   Tab switch tab   Esc clear',
+  'tui.hint.list': 'Space select   ↑↓ move (↑ at top = search)   Tab switch tab   Enter run/submit   Ctrl+A all   Ctrl+O preview',
+  'tui.review.title': 'Review — {count} change(s)',
+  'tui.review.more': '  …and {count} more',
+  'tui.review.hint': 'Enter apply   Esc cancel',
+  'tui.notItemRow': 'Press Enter to run this row.',
+  'tui.noPreview': 'This item has no preview.',
+  'tui.opened': 'Opened: {target}',
+  'tui.noChanges': 'Nothing to change.',
+  'tui.submitCancelled': 'Submission cancelled.',
+  'tui.toggledAll': 'Selected every visible item in the {tab} tab.',
+  'tui.toggledNone': 'Cleared every visible item in the {tab} tab.',
+  'tui.nonInteractive': 'The interactive screen only opens in a terminal. --list and --set work too.',
+  'tui.applyHeader': '{count} change(s) to apply{suffix}:',
+  'tui.pressAnyKey': 'Press any key to continue…',
+  'tui.confirmSuffix': ' [y/N] ',
+
+  // 언어 행(action.language) 전용. 저장 성공·dry-run·실패·강제 로케일 네 갈래를 덮는다.
+  'tui.lang.saved': 'Saved to {path}',
+  'tui.lang.dryRun': 'dry-run — applied to this session only',
+  'tui.lang.saveFailed': 'Could not save the language: {message}',
+  'tui.lang.overridden': '--lang / AGENT_SETUP_LANG still wins on the next run.',
+
+  'item.location.user': 'installs to: user global',
+  // 커버리지는 전부 지원할 때도 찍는다 — 표시가 없는 것과 "10/10"은 뜻이 다르다.
+  'item.cliCoverage': 'CLI {covered}/{total}',
+  'item.unsupportedList': 'not wired for {count}: {groups}',
+  'item.unsupportedGroup': '{clis} — {why}',
+
+  // 상주 언어 행 — 작업 탭 맨 위. hint는 현재 로케일의 자기 이름을 담는다.
+  'action.language.label': 'Language',
+  'action.language.hint': '{current} · Enter to change',
+  'action.bootstrap.label': 'Run bootstrap',
+  'action.bootstrap.hint': 'guides · skills · per-tool config · {present} of {total} files exist',
+  'action.sync.installed.label': 'Update installed',
+  'action.sync.installed.hint': 'refetch installed design.md from their sources',
+  'action.sync.catalog.label': 'Refresh catalog',
+  'action.sync.catalog.hint': 'rebuild the design.md list and categories from sources',
+  'action.sync.stale.label': 'Check stale',
+  'action.sync.stale.hint': 'compare installed copies against their sources by hash',
+
+  // design.md 서브시스템. category.*는 우리가 만든 catch-all id(__other·__local)를
+  // 화면에 낼 때만 쓴다 — 공급자가 준 카테고리는 이미 영어 데이터라 번역하지 않는다.
+  'category.other': 'Other',
+  'category.local': 'In-house',
+  // 항목 탭 안쪽의 성격 그룹. rows.mjs의 GROUP_ORDER가 표시 순서를 정한다.
+  'category.token': 'Token savings',
+  'category.context': 'Code understanding',
+  'category.style': 'Design taste',
+  'category.flow': 'Way of working',
+  'category.service': 'External services',
+  'design.localSuffix': '{id} (local)',
+  'design.localTag': 'local',
+  'design.unknownItem': '  unknown item: {token}',
+  'design.ambiguous': '  ambiguous name \'{token}\' — pick a provider: {options}',
+  'design.provider.count': '  {label}: {count}',
+  'design.provider.failed': '  {label}: failed — {message}',
+  'design.catalog.empty': 'Nothing fetched; leaving the catalog alone.',
+  'design.catalog.planned': '  [dry-run] would refresh to {total} entries',
+  'design.catalog.updated': 'catalog refreshed: {total} entries',
+  'design.none': 'No design.md is installed.',
+  'design.updated': '  ✔ updated {label}',
+  'design.updateFailed': '  ✖ update {label} — {message}',
+  'design.sourceCheckFailed': '  ? {label}: cannot reach the source',
+  'design.allCurrent': 'All installed copies are current.',
+  'design.staleList': '{count} stale: {names}',
+  'design.staleConfirm': 'Update {count} now?',
+  'design.unknownSync': 'Unknown sync action: {action}',
+  'design.write': '  [dry-run] write design-md/{provider}/{name}/DESIGN.md',
+  'design.remove': '  [dry-run] remove design-md/{provider}/{name}',
+  'design.nameClash': '  design.md names collide; using \'{picked}\': {path}',
+  'design.sourceIdClash': '  design.md source ids collide; using \'{picked}\': {path}',
+  'design.noDesignFile': '  no DESIGN.md in this design.md source: {path}',
+  'design.pathMissing': '  cannot find the design.md path: {path}',
+  'design.noPreviewUrl': '  {label}: no preview URL.',
+  'design.openFailed': '  {label}: could not open — open it yourself: {target}',
+  'design.notOpenable': 'not an openable target',
+
+  'error.catalogUnreadable': 'Cannot read the design.md catalog: {path}\n{message}\nRebuild it with `design --sync=catalog`.',
+  'error.responseTooLarge': 'The response exceeded the {limit} byte cap: {url}',
+  'error.badDesignId': 'Invalid design.md identifier: {provider}/{name}',
+  // resolveTokens(--set/--preview 토큰 해석)의 예외 전용 — design.ambiguous와
+  // 같은 상황이지만 로그 줄이 아니라 최상위 예외라 들여쓰기가 없다.
+  'error.ambiguousDesignId': 'ambiguous name \'{token}\' — pick a provider: {options}',
+  'error.designDownload': '{provider}/{name}: DESIGN.md download failed',
+  'error.readmeFetch': 'README fetch failed: HTTP {status}',
+}