@vibgrate/cli 2026.817.1 → 2026.818.1

package/DOCS.md

@@ -41,6 +41,7 @@ For a quick overview, see the [README](./README.md). This document covers everyt
   - [vg impact](#vg-impact)
   - [vg install / vg uninstall](#vg-install)
   - [vg lib](#vg-lib)
+  - [vg locale](#vg-locale)
   - [vg map / vg hubs / vg areas / vg oddities](#vg-map--vg-hubs--vg-areas--vg-oddities)
   - [vg llm-host](#vg-llm-host)
   - [vg models](#vg-models)
@@ -1099,6 +1100,66 @@ vg lib refresh          # Re-ingest all local sources
 
 ---
 
+### vg locale
+
+**Vibgrate Localize** — managed localisation for your application. Locale projects, keys, and
+translations live in Vibgrate Cloud and sync with the locale files in your repo.
+
+`vg localize` is a backward-friendly alias; `vg locale` is the canonical form.
+
+```bash
+vg locale config --project <slug> [--target-languages fr-FR,de-DE] [--namespaces common,checkout]
+vg locale push [--dry-run] [--source-only]
+vg locale pull [--language <code>] [--dry-run] [--include-machine]
+vg locale save-missing [--dry-run]
+vg locale add <key> [value] [--namespace <ns>] [--language <code>]
+vg locale remove <keys...> [--namespace <ns>]
+vg locale get <key> [--namespace <ns>] [--language <code>]
+vg locale status
+vg locale format [--dry-run]
+```
+
+| Command | Description |
+|---------|-------------|
+| `vg locale config` | Create or update `vibgrate.locale.yaml` (no credentials are stored in it) |
+| `vg locale push` | Upload local locale files to Vibgrate Cloud (`vg locale sync` is an alias) |
+| `vg locale pull` | Write translations from Vibgrate Cloud into local files (`vg locale download` is an alias) |
+| `vg locale save-missing` | Create only the keys Cloud does not have yet — never overwrites a translation |
+| `vg locale add` | Add or update a single key |
+| `vg locale remove` | Remove one or more keys |
+| `vg locale get` | Show one key and its translations |
+| `vg locale status` | Coverage and health per language |
+| `vg locale format` | Re-format local locale files in place |
+
+**Local vs Cloud.** `config` and `format` only touch the filesystem — they work on any plan and make
+no network call. Everything else reads or writes Vibgrate Cloud and needs a **Team plan or above**.
+`vg locale push --dry-run` also works with no credentials, so you can preview what a push would send
+before you have logged in.
+
+**Configuration** lives in `vibgrate.locale.yaml`, which is safe to commit — the DSN is never written
+to it and resolves at call time from `--dsn`, `VIBGRATE_DSN`, or your stored login, exactly as
+`vg push` does.
+
+```yaml
+project: acme-web
+sourceLanguage: en-US
+targetLanguages: [fr-FR, de-DE]
+format: nested
+path: src/locales/{language}/{namespace}.json
+namespaces: [common, checkout]
+version: latest
+```
+
+**Formats.** `json`, `nested`, `flat`, `yaml`, and `yml` are supported today; the professional
+formats (`po`, `xliff`, `xliff2`, `android`, `strings`, `resx`, `csv`, `arb`, `properties`) report
+that they are not available yet rather than failing as unknown. Every codec round-trips, and writes
+are key-sorted so pulling twice never produces a spurious diff.
+
+**Machine translation is never silently accepted.** `pull` writes only translations a person has
+accepted; pass `--include-machine` to also write machine and needs-review entries.
+
+---
+
 ### vg map / vg hubs / vg areas / vg oddities
 
 Map-level insights — read-only views over the committed graph.

package/README.md

@@ -534,6 +534,7 @@ Under each set, commands are listed A–Z. A short **typical path** (usual order
 | `vg impact <file>` | What breaks if you change it — and the tests to run |
 | `vg install` / `vg uninstall` | Wire (or remove) **Vibgrate AI Context** + skill in your AI assistant (`--detect`, `--all`, `--list`) |
 | `vg lib <package>` | Version-correct, drift-annotated library docs |
+| `vg locale` | Manage your app's translations — locale projects, keys, and translations in Vibgrate Cloud (`push` / `pull` / `status`; `vg localize` is an alias) |
 | `vg map` / `vg hubs` / `vg areas` / `vg oddities` | Map insights: overview, most-depended-on code, natural groupings, cross-area smells |
 | `vg models` | Code Modes (Spark / Flow / Forge) + local fleet (Ollama / LM Studio / gguf); `install` / `pull` by default (`--dry-run` to preview) |
 | `vg module` | Manage optional local modules (`relevance`, `hcs`): `status`, `install`, `remove` |

package/dist/activity-MF2GNYAI.js

@@ -0,0 +1,5 @@
+export { ActivityLog, formatMs } from './chunk-H5Q4JUY4.js';
+import './chunk-CT5BS56U.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=activity-MF2GNYAI.js.map
+//# sourceMappingURL=activity-MF2GNYAI.js.map

package/dist/activity-MF2GNYAI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"activity-MF2GNYAI.js"}

package/dist/agent-CUK24AWF.js

@@ -0,0 +1,30 @@
+export { CONTEXT_POLICY_VERSION, DISCOVERY_TOOLS, MUTATION_TOOLS, compact, compactWithModel, runAgent } from './chunk-4QAMUBAC.js';
+import './chunk-543E6WDJ.js';
+import './chunk-74UBGF4P.js';
+import './chunk-3HNPVXUK.js';
+import './chunk-DH6EDSQP.js';
+import './chunk-X4DECFUG.js';
+import './chunk-5HYCB55P.js';
+import './chunk-VIWZ4QT7.js';
+import './chunk-OVUZWR67.js';
+export { summarizeCapsule } from './chunk-6LY3JH6S.js';
+import './chunk-EZ7UC5Y5.js';
+import './chunk-6BEBJCK4.js';
+import './chunk-J7LKEB2R.js';
+import './chunk-DUCEKH7Q.js';
+import './chunk-NO4BMW7M.js';
+import './chunk-NDNNOAS6.js';
+import './chunk-J3A3O4IA.js';
+import './chunk-T7RSQ5WD.js';
+import './chunk-6WRG7VDO.js';
+import './chunk-WVTGF2MP.js';
+import './chunk-Q7TWHJJ6.js';
+import './chunk-MVPRPSXU.js';
+import './chunk-O3LABX6I.js';
+import './chunk-SUD54UGN.js';
+import './chunk-BWPBB45M.js';
+import './chunk-JFGYT6BI.js';
+import './chunk-BPF3YX2U.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=agent-CUK24AWF.js.map
+//# sourceMappingURL=agent-CUK24AWF.js.map

package/dist/{agent-CUYQKC6S.js.map → agent-CUK24AWF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-CUYQKC6S.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-CUK24AWF.js"}

package/dist/{approvals-IPMUDEDV.js → approvals-YFOU6GVB.js}

@@ -1,9 +1,10 @@
-export { addApprovalRule, approvalsPath, findMatchingRule, globMatch, loadApprovalRules, normalizeCommandPrefix, removeApprovalRule, ruleForAction, ruleKey, ruleLabel, saveApprovalRules } from './chunk-ZSECAGSU.js';
-import './chunk-ENFSSUNK.js';
-import './chunk-PV76EO4G.js';
+export { addApprovalRule, approvalsPath, findMatchingRule, globMatch, loadApprovalRules, normalizeCommandPrefix, removeApprovalRule, ruleForAction, ruleKey, ruleLabel, saveApprovalRules } from './chunk-DH6EDSQP.js';
+import './chunk-Q7TWHJJ6.js';
+import './chunk-O3LABX6I.js';
+import './chunk-SUD54UGN.js';
 import './chunk-BWPBB45M.js';
 import './chunk-JFGYT6BI.js';
 import './chunk-BPF3YX2U.js';
 import './chunk-Z6ZWNWWR.js';
-//# sourceMappingURL=approvals-IPMUDEDV.js.map
-//# sourceMappingURL=approvals-IPMUDEDV.js.map
+//# sourceMappingURL=approvals-YFOU6GVB.js.map
+//# sourceMappingURL=approvals-YFOU6GVB.js.map

package/dist/{approvals-IPMUDEDV.js.map → approvals-YFOU6GVB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"approvals-IPMUDEDV.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"approvals-YFOU6GVB.js"}

package/dist/attach-6S3XS7VO.js

@@ -0,0 +1,9 @@
+export { attachVgd, daemonDisabledReason } from './chunk-G7ZFSH5J.js';
+import './chunk-NO4BMW7M.js';
+import './chunk-NDNNOAS6.js';
+import './chunk-BWPBB45M.js';
+import './chunk-JFGYT6BI.js';
+import './chunk-BPF3YX2U.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=attach-6S3XS7VO.js.map
+//# sourceMappingURL=attach-6S3XS7VO.js.map

package/dist/attach-6S3XS7VO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"attach-6S3XS7VO.js"}

package/dist/baseline-OBZJRCCP.js

@@ -0,0 +1,9 @@
+export { baselineCommand, runBaseline } from './chunk-6ABMV74F.js';
+import './chunk-V2UGRUTL.js';
+import './chunk-NG4KIJW6.js';
+import './chunk-CRAMOEBE.js';
+import './chunk-T7RSQ5WD.js';
+import './chunk-SUD54UGN.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=baseline-OBZJRCCP.js.map
+//# sourceMappingURL=baseline-OBZJRCCP.js.map

package/dist/{baseline-NZFGLMER.js.map → baseline-OBZJRCCP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-NZFGLMER.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-OBZJRCCP.js"}