Arena/cc711495 bolt cli

.bolt/agent/orchestrator.md

@@ -0,0 +1,59 @@
+---
+mode: primary
+hidden: false
+color: "#9B59B6"
+tools:
+  "*": true
+---
+
+You are an orchestrator agent responsible for coordinating complex multi-step tasks by delegating work to specialized agents.
+
+Your role is to:
+
+1. Understand the user's request and break it down into logical steps
+2. Analyze the codebase context to understand dependencies and impact
+3. Create a step-by-step plan for the task
+4. Execute each step by delegating to the most appropriate specialized agent
+5. Verify results and report completion
+
+## When to Delegate
+
+Delegate to specialized agents based on the nature of the subtask:
+
+- **code agent**: Implementation, writing code, fixing bugs, adding features
+- **plan agent**: Architecture exploration, producing plans without changing code
+- **debug agent**: Troubleshooting failing tests, crashes, and logic errors
+- **refactor agent**: Safe refactoring with test verification
+- **docs agent**: Writing and updating documentation
+- **security agent**: Security audits and vulnerability checks
+- **migrate agent**: Framework upgrades and dependency migrations
+- **perf agent**: Performance analysis and optimization
+- **code-review agent**: Reviewing changes for correctness and style
+
+## Workflow
+
+For complex tasks:
+
+1. First, explore the codebase to understand the current state
+2. Break down the task into clear, actionable steps
+3. For each step, choose the right agent and delegate the work
+4. Monitor progress and verify each step completes successfully
+5. Report back with a summary of what was accomplished
+
+Use the task tool to delegate work to subagents. Be specific about what each subagent should accomplish and provide sufficient context.
+
+## Example
+
+User: "Add authentication to this API"
+
+Your approach:
+
+1. Explore the current API structure
+2. Plan the authentication implementation (JWT, session, OAuth, etc.)
+3. Delegate to plan agent for architecture decisions
+4. Delegate to code agent for implementation
+5. Delegate to security agent for review
+6. Delegate to docs agent for documentation updates
+7. Verify and report completion
+
+Always keep the user informed of progress and any decisions you make during orchestration.

.bolt/glossary/README.md

@@ -0,0 +1,63 @@
+# Locale Glossaries
+
+Use this folder for locale-specific translation guidance that supplements `.bolt/agent/translator.md`.
+
+The global glossary in `translator.md` remains the source of truth for shared do-not-translate terms (commands, code, paths, product names, etc.). These locale files capture community learnings about phrasing and terminology preferences.
+
+## File Naming
+
+- One file per locale
+- Use lowercase locale slugs that match docs locales when possible (for example, `zh-cn.md`, `zh-tw.md`)
+- If only language-level guidance exists, use the language code (for example, `fr.md`)
+- Some repo locale slugs may be aliases/non-BCP47 for consistency (for example, `br` for Brazilian Portuguese / `pt-BR`)
+
+## What To Put In A Locale File
+
+- **Sources**: PRs/issues/discussions that motivated the guidance
+- **Do Not Translate (Locale Additions)**: locale-specific terms or casing decisions
+- **Preferred Terms**: recurring UI/docs words with preferred translations
+- **Guidance**: tone, style, and consistency notes
+- **Avoid** (optional): common literal translations or wording we should avoid
+- If the repo uses a locale alias slug, document the alias in **Guidance** (for example, prose may mention `pt-BR` while config/examples use `br`)
+
+Prefer guidance that is:
+
+- Repeated across multiple docs/screens
+- Easy to apply consistently
+- Backed by a community contribution or review discussion
+
+## Template
+
+```md
+# <locale> Glossary
+
+## Sources
+
+- PR #12345: https://github.com/Bolt-builder/bolt-cli/pull/12345
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing)
+
+## Preferred Terms
+
+| English | Preferred | Notes     |
+| ------- | --------- | --------- |
+| prompt  | ...       | preferred |
+| session | ...       | preferred |
+
+## Guidance
+
+- Prefer natural phrasing over literal translation
+
+## Avoid
+
+- Avoid ... when ...
+```
+
+## Contribution Notes
+
+- Mark entries as preferred when they may evolve
+- Keep examples short
+- Add or update the `Sources` section whenever you add a new rule
+- Prefer PR-backed guidance over invented term mappings; start with general guidance if no term-level corrections exist yet

.bolt/glossary/ar.md

@@ -0,0 +1,28 @@
+# ar Glossary
+
+## Sources
+
+- PR #9947: https://github.com/Bolt-builder/bolt-cli/pull/9947
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural Arabic phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+- For RTL text, treat code, commands, and paths as LTR artifacts and keep their character order unchanged
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple Arabic terms for the same recurring UI action once a preferred term is established

.bolt/glossary/br.md

@@ -0,0 +1,34 @@
+# br Glossary
+
+## Sources
+
+- PR #10086: https://github.com/Bolt-builder/bolt-cli/pull/10086
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Locale code `br` in repo config, code, and paths (repo alias for Brazilian Portuguese)
+
+## Preferred Terms
+
+These are PR-backed locale naming preferences and may evolve.
+
+| English / Context                        | Preferred                      | Notes                                                         |
+| ---------------------------------------- | ------------------------------ | ------------------------------------------------------------- |
+| Brazilian Portuguese (prose locale name) | `pt-BR`                        | Use standard locale naming in prose when helpful              |
+| Repo locale slug (code/config)           | `br`                           | PR #10086 uses `br` for consistency/simplicity                |
+| Browser locale detection                 | `pt`, `pt-br`, `pt-BR` -> `br` | Preserve this mapping in docs/examples about locale detection |
+
+## Guidance
+
+- This file covers Brazilian Portuguese (`pt-BR`), but the repo locale code is `br`
+- Use natural Brazilian Portuguese phrasing over literal translation
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+- Keep repo locale identifiers as implemented in code/config (`br`) even when prose mentions `pt-BR`
+
+## Avoid
+
+- Avoid changing repo locale code references from `br` to `pt-br` in code snippets, paths, or config examples
+- Avoid mixing Portuguese variants when a Brazilian Portuguese form is established

.bolt/glossary/bs.md

@@ -0,0 +1,33 @@
+# bs Glossary
+
+## Sources
+
+- PR #12283: https://github.com/Bolt-builder/bolt-cli/pull/12283
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+These are PR-backed locale naming preferences and may evolve.
+
+| English / Context                  | Preferred  | Notes                                             |
+| ---------------------------------- | ---------- | ------------------------------------------------- |
+| Bosnian language label (UI)        | `Bosanski` | PR #12283 tested switching language to `Bosanski` |
+| Repo locale slug (code/config)     | `bs`       | Preserve in code, config, paths, and examples     |
+| Browser locale detection (Bosnian) | `bs`       | PR #12283 added `bs` locale auto-detection        |
+
+## Guidance
+
+- Use natural Bosnian phrasing over literal translation
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+- Keep repo locale references as `bs` in code/config, and use `Bosanski` for the user-facing language name when applicable
+
+## Avoid
+
+- Avoid changing repo locale references from `bs` to another slug in code snippets or config examples
+- Avoid translating product and protocol names that are fixed identifiers

.bolt/glossary/da.md

@@ -0,0 +1,27 @@
+# da Glossary
+
+## Sources
+
+- PR #9821: https://github.com/Bolt-builder/bolt-cli/pull/9821
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural Danish phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple Danish terms for the same recurring UI action once a preferred term is established

.bolt/glossary/de.md

@@ -0,0 +1,27 @@
+# de Glossary
+
+## Sources
+
+- PR #9817: https://github.com/Bolt-builder/bolt-cli/pull/9817
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural German phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple German terms for the same recurring UI action once a preferred term is established

.bolt/glossary/es.md

@@ -0,0 +1,27 @@
+# es Glossary
+
+## Sources
+
+- PR #9817: https://github.com/Bolt-builder/bolt-cli/pull/9817
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural Spanish phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple Spanish terms for the same recurring UI action once a preferred term is established

.bolt/glossary/fr.md

@@ -0,0 +1,27 @@
+# fr Glossary
+
+## Sources
+
+- PR #9821: https://github.com/Bolt-builder/bolt-cli/pull/9821
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural French phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple French terms for the same recurring UI action once a preferred term is established

.bolt/glossary/ja.md

@@ -0,0 +1,33 @@
+# ja Glossary
+
+## Sources
+
+- PR #9821: https://github.com/Bolt-builder/bolt-cli/pull/9821
+- PR #13160: https://github.com/Bolt-builder/bolt-cli/pull/13160
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+These are PR-backed wording preferences and may evolve.
+
+| English / Context           | Preferred               | Notes                                 |
+| --------------------------- | ----------------------- | ------------------------------------- |
+| WSL integration (UI label)  | `WSL連携`               | PR #13160 prefers this over `WSL統合` |
+| WSL integration description | `WindowsのWSL環境で...` | PR #13160 improved phrasing naturally |
+
+## Guidance
+
+- Prefer natural Japanese phrasing over literal translation
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+- In WSL integration text, follow PR #13160 wording direction for more natural Japanese phrasing
+
+## Avoid
+
+- Avoid `WSL統合` in the WSL integration UI context where `WSL連携` is the reviewed wording
+- Avoid translating product and protocol names that are fixed identifiers

.bolt/glossary/ko.md

@@ -0,0 +1,27 @@
+# ko Glossary
+
+## Sources
+
+- PR #9817: https://github.com/Bolt-builder/bolt-cli/pull/9817
+
+## Do Not Translate (Locale Additions)
+
+- `Bolt` (preserve casing in prose; keep `opencode` only in commands, package names, paths, or code)
+- `Bolt CLI`
+- `CLI`, `TUI`, `MCP`, `OAuth`
+- Commands, flags, file paths, and code literals (keep exactly as written)
+
+## Preferred Terms
+
+No PR-backed term mappings yet. Add entries here when review PRs introduce repeated wording corrections.
+
+## Guidance
+
+- Prefer natural Korean phrasing over literal translation
+- Keep tone clear and direct in UI labels and docs prose
+- Preserve technical artifacts exactly: commands, flags, code, URLs, model IDs, and file paths
+
+## Avoid
+
+- Avoid translating product and protocol names that are fixed identifiers
+- Avoid mixing multiple Korean terms for the same recurring UI action once a preferred term is established