@intlayer/docs 9.5.1 → 9.5.2

package/docs/ar/cli/ci.md

@@ -1,186 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: أمر CI
-description: تعلم كيفية استخدام أمر Intlayer CI لتشغيل أوامر Intlayer مع بيانات الاعتماد المحقونة تلقائياً في خطوط أنابيب CI/CD والمستودعات الأحادية.
-keywords:
-  - CI
-  - CI/CD
-  - الأتمتة
-  - المستودع الأحادي
-  - بيانات الاعتماد
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "إضافة أمر CI"
-author: aymericzip
----
-
-# أمر CI
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x intlayer ci <command...>
-```
-
-تم تصميم أمر CI للأتمتة وخطوط أنابيب CI/CD. يقوم بحقن بيانات الاعتماد تلقائياً من متغير البيئة `INTLAYER_PROJECT_CREDENTIALS` ويمكنه تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي.
-
-## كيفية العمل
-
-يعمل أمر CI في وضعين:
-
-1. **وضع المشروع الواحد**: إذا كان الدليل الحالي يطابق أحد مسارات المشاريع في `INTLAYER_PROJECT_CREDENTIALS`، فإنه يشغل الأمر فقط لهذا المشروع المحدد.
-
-2. **وضع التكرار**: إذا لم يتم اكتشاف سياق مشروع محدد، فإنه يتكرر عبر جميع المشاريع المُكوّنة ويشغل الأمر لكل واحد منها.
-
-## متغير البيئة
-
-يتطلب الأمر تعيين متغير البيئة `INTLAYER_PROJECT_CREDENTIALS`. يجب أن يحتوي هذا المتغير على كائن JSON يقوم بتعيين مسارات المشاريع إلى بيانات اعتمادها:
-
-```json
-{
-  "packages/app": {
-    "clientId": "your-client-id-1",
-    "clientSecret": "your-client-secret-1"
-  },
-  "packages/admin": {
-    "clientId": "your-client-id-2",
-    "clientSecret": "your-client-secret-2"
-  }
-}
-```
-
-## اكتشاف مدير الحزم
-
-يكتشف أمر CI تلقائياً مدير الحزم المستخدم (npm أو yarn أو pnpm أو bun) بناءً على متغير البيئة `npm_config_user_agent` ويستخدم الأمر المناسب لتنفيذ Intlayer.
-
-## الوسائط
-
-- **`<command...>`**: أمر Intlayer المراد تنفيذه (على سبيل المثال، `fill` أو `push` أو `build`). يمكنك تمرير أي أمر Intlayer ووسائطه.
-
-  > مثال: `npx intlayer ci fill --verbose`
-  >
-  > مثال: `npx intlayer ci push`
-  >
-  > مثال: `npx intlayer ci build`
-
-## أمثلة
-
-### تشغيل أمر في وضع المشروع الواحد
-
-إذا كنت في دليل مشروع يطابق أحد المسارات في `INTLAYER_PROJECT_CREDENTIALS`:
-
-```bash
-cd packages/app
-npx intlayer ci fill
-```
-
-سيقوم هذا بتشغيل أمر `fill` مع حقن بيانات الاعتماد تلقائياً لمشروع `packages/app`.
-
-### تشغيل أمر عبر جميع المشاريع
-
-إذا كنت في دليل لا يطابق أي مسار مشروع، سيتكرر الأمر عبر جميع المشاريع المُكوّنة:
-
-```bash
-cd /path/to/monorepo
-npx intlayer ci push
-```
-
-سيقوم هذا بتشغيل أمر `push` لكل مشروع مُكوّن في `INTLAYER_PROJECT_CREDENTIALS`.
-
-### تمرير علامات إضافية
-
-يمكنك تمرير أي علامات إلى أمر Intlayer الأساسي:
-
-```bash packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### الاستخدام في خطوط أنابيب CI/CD
-
-تشغيل `intlayer init` ينشئ لك سير عمل GitHub Actions جاهزة للاستخدام (انظر [سير العمل المُنشأ من GitHub Actions](#scaffolded-github-actions) أدناه). يوضح المثال هنا إعداد معادل باستخدام أمر `ci` لـ monorepo، حيث يتم حقن بيانات الاعتماد لكل مشروع من `INTLAYER_PROJECT_CREDENTIALS`.
-
-في تكوين CI/CD الخاص بك (على سبيل المثال، GitHub Actions أو GitLab CI)، قم بتعيين `INTLAYER_PROJECT_CREDENTIALS` كسر:
-
-```yaml
-# مثال GitHub Actions
-env:
-  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
-
-steps:
-  - name: ملء القواميس
-    run: npx intlayer ci fill
-```
-
-## إجراءات GitHub المُنشأة تلقائياً
-
-عند تشغيل `intlayer init`، يكتشف Intlayer مدير الحزم الخاص بك (npm أو yarn أو pnpm أو bun) وينشئ سير عملين من إجراءات GitHub تحت `.github/workflows/`، مع أوامر تطابق مدير الحزم هذا:
-
-- **`intlayer-fill.yml`** — في كل طلب دمج، ينشئ القواميس ويشغل `intlayer fill --git-diff --mode complete` لإنشاء الترجمات المفقودة للقواميس المتغيرة، ثم يرسل النتيجة مرة أخرى إلى فرع طلب الدمج.
-- **`intlayer-test.yml`** — في كل طلب دمج، ينشئ القواموس ويشغل `intlayer test`، ويفشل الفحص عندما تكون الترجمات المطلوبة مفقودة للغات المطلوبة.
-
-لن يتم استبدال ملفات سير العمل الموجودة. لتخطي الإنشاء بالكامل، قم بتشغيل:
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### توفير وصول الذكاء الاصطناعي لسير العمل fill
-
-ملف `intlayer-fill.yml` المُنشأ يتطلب وصول الذكاء الاصطناعي. يتوفر خياران (مُكوّنان في كتلة `env` في سير العمل):
-
-1. **مفتاح مزود الذكاء الاصطناعي الخاص بك** — أضف سراً `AI_API_KEY` في إعدادات المستودع (Settings → Secrets and variables → Actions). يقوم سير العمل بإعادة توجيهه عبر `--provider` و `--model` و `--api-key`.
-2. **مفاتيح وصول Intlayer CMS** — أضف أسراراً `INTLAYER_CLIENT_ID` و `INTLAYER_CLIENT_SECRET` وربطها في قسم `editor` الخاص بك في `intlayer.config`. مفاتيح وصول CMS تمنح وصول الذكاء الاصطناعي من خلال خادم Intlayer الخلفي.
-
-سير العمل `intlayer-test.yml` لا يتطلب أي وصول للذكاء الاصطناعي.
-
-## معالجة الأخطاء
-
-- إذا لم يتم تعيين `INTLAYER_PROJECT_CREDENTIALS`، فسيخرج الأمر مع خطأ.
-- إذا لم يكن `INTLAYER_PROJECT_CREDENTIALS` JSON صالحاً، فسيخرج الأمر مع خطأ.
-- إذا لم يكن مسار المشروع موجوداً، فسيتم تخطيه مع تحذير.
-- إذا فشل أي مشروع، فسيخرج الأمر برمز حالة غير صفري.
-
-## حالات الاستخدام
-
-- **أتمتة المستودع الأحادي**: تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي
-- **خطوط أنابيب CI/CD**: أتمتة إدارة القواميس في سير عمل التكامل المستمر
-- **العمليات المجمعة**: تنفيذ نفس العملية على مشاريع Intlayer متعددة في وقت واحد
-- **إدارة الأسرار**: إدارة بيانات الاعتماد بشكل آمن لعدة مشاريع باستخدام متغيرات البيئة
-
-## أفضل ممارسات الأمان
-
-- قم بتخزين `INTLAYER_PROJECT_CREDENTIALS` كأسرار مشفرة في منصة CI/CD الخاصة بك
-- لا تقم أبداً بإيداع بيانات الاعتماد في التحكم بالإصدارات
-- استخدم بيانات اعتماد خاصة بالبيئة لبيئات النشر المختلفة
-- قم بتدوير بيانات الاعتماد بانتظام

package/docs/de/cli/ci.md

@@ -1,186 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: CI-Befehl
-description: Erfahren Sie, wie Sie den Intlayer CI-Befehl verwenden, um Intlayer-Befehle mit automatisch injizierten Anmeldedaten in CI/CD-Pipelines und Monorepos auszuführen.
-keywords:
-  - CI
-  - CI/CD
-  - Automatisierung
-  - Monorepo
-  - Anmeldedaten
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "CI-Befehl hinzufügen"
-author: aymericzip
----
-
-# CI-Befehl
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x intlayer ci <command...>
-```
-
-Der CI-Befehl ist für Automatisierung und CI/CD-Pipelines konzipiert. Er injiziert automatisch Anmeldedaten aus der Umgebungsvariable `INTLAYER_PROJECT_CREDENTIALS` und kann Intlayer-Befehle über mehrere Projekte in einem Monorepo ausführen.
-
-## Funktionsweise
-
-Der CI-Befehl arbeitet in zwei Modi:
-
-1. **Einzelprojektmodus**: Wenn das aktuelle Arbeitsverzeichnis mit einem der Projektpfade in `INTLAYER_PROJECT_CREDENTIALS` übereinstimmt, führt er den Befehl nur für dieses spezifische Projekt aus.
-
-2. **Iterationsmodus**: Wenn kein spezifischer Projektkontext erkannt wird, iteriert er über alle konfigurierten Projekte und führt den Befehl für jedes aus.
-
-## Umgebungsvariable
-
-Der Befehl erfordert, dass die Umgebungsvariable `INTLAYER_PROJECT_CREDENTIALS` gesetzt ist. Diese Variable sollte ein JSON-Objekt enthalten, das Projektpfade ihren Anmeldedaten zuordnet:
-
-```json
-{
-  "packages/app": {
-    "clientId": "your-client-id-1",
-    "clientSecret": "your-client-secret-1"
-  },
-  "packages/admin": {
-    "clientId": "your-client-id-2",
-    "clientSecret": "your-client-secret-2"
-  }
-}
-```
-
-## Paketmanager-Erkennung
-
-Der CI-Befehl erkennt automatisch, welcher Paketmanager verwendet wird (npm, yarn, pnpm oder bun), basierend auf der Umgebungsvariable `npm_config_user_agent`, und verwendet den entsprechenden Befehl zur Ausführung von Intlayer.
-
-## Argumente
-
-- **`<command...>`**: Der auszuführende Intlayer-Befehl (z. B. `fill`, `push`, `build`). Sie können jeden Intlayer-Befehl und seine Argumente übergeben.
-
-  > Beispiel: `npx intlayer ci fill --verbose`
-  >
-  > Beispiel: `npx intlayer ci push`
-  >
-  > Beispiel: `npx intlayer ci build`
-
-## Beispiele
-
-### Befehl im Einzelprojektmodus ausführen
-
-Wenn Sie sich in einem Projektverzeichnis befinden, das mit einem der Pfade in `INTLAYER_PROJECT_CREDENTIALS` übereinstimmt:
-
-```bash
-cd packages/app
-npx intlayer ci fill
-```
-
-Dies führt den Befehl `fill` mit automatisch injizierten Anmeldedaten für das Projekt `packages/app` aus.
-
-### Befehl für alle Projekte ausführen
-
-Wenn Sie sich in einem Verzeichnis befinden, das mit keinem Projektpfad übereinstimmt, iteriert der Befehl über alle konfigurierten Projekte:
-
-```bash
-cd /path/to/monorepo
-npx intlayer ci push
-```
-
-Dies führt den Befehl `push` für jedes in `INTLAYER_PROJECT_CREDENTIALS` konfigurierte Projekt aus.
-
-### Zusätzliche Flags übergeben
-
-Sie können beliebige Flags an den zugrunde liegenden Intlayer-Befehl übergeben:
-
-```bash packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### Verwendung in CI/CD-Pipelines
-
-Das Ausführen von `intlayer init` erstellt zwei einsatzbereite GitHub Actions-Workflows für Sie (siehe [Scaffolded GitHub Actions](#scaffolded-github-actions) unten). Das Beispiel hier zeigt das äquivalente Setup mit dem `ci`-Befehl für ein Monorepo, bei dem Anmeldedaten pro Projekt aus `INTLAYER_PROJECT_CREDENTIALS` injiziert werden.
-
-In Ihrer CI/CD-Konfiguration (z. B. GitHub Actions, GitLab CI) setzen Sie `INTLAYER_PROJECT_CREDENTIALS` als Geheimnis:
-
-```yaml
-# GitHub Actions Beispiel
-env:
-  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
-
-steps:
-  - name: Wörterbücher füllen
-    run: npx intlayer ci fill
-```
-
-## Gerüstete GitHub Actions
-
-Wenn Sie `intlayer init` ausführen, erkennt Intlayer Ihren Paketmanager (npm, yarn, pnpm oder bun) und erstellt zwei GitHub Actions-Workflows unter `.github/workflows/` mit Befehlen, die diesem Paketmanager entsprechen:
-
-- **`intlayer-fill.yml`** — Bei jedem Pull Request werden die Wörterbücher erstellt und `intlayer fill --git-diff --mode complete` ausgeführt, um fehlende Übersetzungen für die geänderten Wörterbücher zu generieren, und dann wird das Ergebnis auf den PR-Branch committed.
-- **`intlayer-test.yml`** — Bei jedem Pull Request werden die Wörterbücher erstellt und `intlayer test` ausgeführt, wobei die Prüfung fehlschlägt, wenn erforderliche Lokalisierungen fehlende Übersetzungen haben.
-
-Vorhandene Workflow-Dateien werden niemals überschrieben. Um das Scaffolding vollständig zu überspringen, führen Sie aus:
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### AI-Zugriff für den Fill-Workflow bereitstellen
-
-Die gerüstete `intlayer-fill.yml` erfordert AI-Zugriff. Es stehen zwei Optionen zur Verfügung (konfiguriert im `env`-Block des Workflows):
-
-1. **Ihr eigener AI-Provider-Schlüssel** — Fügen Sie ein `AI_API_KEY`-Secret in Ihren Repository-Einstellungen hinzu (Settings → Secrets and variables → Actions). Der Workflow leitet ihn über `--provider`, `--model` und `--api-key` weiter.
-2. **Intlayer CMS-Zugangsschlüssel** — Fügen Sie `INTLAYER_CLIENT_ID` und `INTLAYER_CLIENT_SECRET`-Secrets hinzu und verbinden Sie sie mit Ihrem `intlayer.config` `editor`-Abschnitt. CMS-Zugangsschlüssel gewähren AI-Zugriff über das Intlayer-Backend.
-
-Der `intlayer-test.yml`-Workflow erfordert keinen AI-Zugriff.
-
-## Fehlerbehandlung
-
-- Wenn `INTLAYER_PROJECT_CREDENTIALS` nicht gesetzt ist, beendet sich der Befehl mit einem Fehler.
-- Wenn `INTLAYER_PROJECT_CREDENTIALS` kein gültiges JSON ist, beendet sich der Befehl mit einem Fehler.
-- Wenn ein Projektpfad nicht existiert, wird er mit einer Warnung übersprungen.
-- Wenn ein Projekt fehlschlägt, beendet sich der Befehl mit einem Statuscode ungleich null.
-
-## Anwendungsfälle
-
-- **Monorepo-Automatisierung**: Intlayer-Befehle über mehrere Projekte in einem Monorepo ausführen
-- **CI/CD-Pipelines**: Automatisierung der Wörterbuchverwaltung in Continuous-Integration-Workflows
-- **Massenoperationen**: Dieselbe Operation gleichzeitig für mehrere Intlayer-Projekte durchführen
-- **Geheimnisverwaltung**: Sichere Verwaltung von Anmeldedaten für mehrere Projekte mithilfe von Umgebungsvariablen
-
-## Sicherheitsbest Practices
-
-- Speichern Sie `INTLAYER_PROJECT_CREDENTIALS` als verschlüsselte Geheimnisse in Ihrer CI/CD-Plattform
-- Committen Sie niemals Anmeldedaten in die Versionskontrolle
-- Verwenden Sie umgebungsspezifische Anmeldedaten für verschiedene Bereitstellungsumgebungen
-- Rotieren Sie Anmeldedaten regelmäßig

package/docs/en/cli/ci.md

@@ -1,216 +0,0 @@
----
-createdAt: 2026-01-06
-updatedAt: 2026-01-06
-title: CI Command
-description: Learn how to use the Intlayer CI command to run Intlayer commands with auto-injected credentials in CI/CD pipelines and monorepos.
-keywords:
-  - CI
-  - CI/CD
-  - Automation
-  - Monorepo
-  - Credentials
-  - CLI
-  - Intlayer
-slugs:
-  - doc
-  - concept
-  - cli
-  - ci
-history:
-  - version: 7.5.11
-    date: 2026-01-06
-    changes: "Add CI command"
-author: aymericzip
----
-
-# CI Command
-
-```bash packageManager="npm"
-npx intlayer ci <command...>
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci <command...>
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci <command...>
-```
-
-```bash packageManager="bun"
-bun x intlayer ci <command...>
-```
-
-The CI command is designed for automation and CI/CD pipelines. It automatically injects credentials from the `INTLAYER_PROJECT_CREDENTIALS` environment variable and can run Intlayer commands across multiple projects in a monorepo.
-
-## How it works
-
-The CI command operates in two modes:
-
-1. **Single Project Mode**: If the current working directory matches one of the project paths in `INTLAYER_PROJECT_CREDENTIALS`, it runs the command for that specific project only.
-
-2. **Iteration Mode**: If no specific project context is detected, it iterates over all configured projects and runs the command for each one.
-
-## Environment Variable
-
-The command requires the `INTLAYER_PROJECT_CREDENTIALS` environment variable to be set. This variable should contain a JSON object mapping project paths to their credentials:
-
-```json
-{
-  "packages/app": {
-    "clientId": "your-client-id-1",
-    "clientSecret": "your-client-secret-1"
-  },
-  "packages/admin": {
-    "clientId": "your-client-id-2",
-    "clientSecret": "your-client-secret-2"
-  }
-}
-```
-
-## Package Manager Detection
-
-The CI command automatically detects which package manager is being used (npm, yarn, pnpm, or bun) based on the `npm_config_user_agent` environment variable and uses the appropriate command to execute Intlayer.
-
-## Arguments
-
-- **`<command...>`**: The Intlayer command to execute (e.g., `fill`, `push`, `build`). You can pass any Intlayer command and its arguments.
-
-  > Example: `npx intlayer ci fill --verbose`
-  >
-  > Example: `npx intlayer ci push`
-  >
-  > Example: `npx intlayer ci build`
-
-## Examples
-
-### Run a command in single project mode
-
-If you're in a project directory that matches one of the paths in `INTLAYER_PROJECT_CREDENTIALS`:
-
-```bash
-cd packages/app
-npx intlayer ci fill
-```
-
-This will run the `fill` command with credentials automatically injected for the `packages/app` project.
-
-### Run a command across all projects
-
-If you're in a directory that doesn't match any project path, the command will iterate over all configured projects:
-
-```bash
-cd /path/to/monorepo
-npx intlayer ci push
-```
-
-This will run the `push` command for each project configured in `INTLAYER_PROJECT_CREDENTIALS`.
-
-### Pass additional flags
-
-You can pass any flags to the underlying Intlayer command:
-
-```bash packageManager="npm"
-npx intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="yarn"
-yarn intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer ci fill --verbose --mode complete
-```
-
-```bash packageManager="bun"
-bun x intlayer ci fill --verbose --mode complete
-```
-
-### Use in CI/CD pipelines
-
-Running `intlayer init` scaffolds two ready-to-use GitHub Actions workflows for you (see [Scaffolded GitHub Actions](#scaffolded-github-actions) below). The example here shows the equivalent setup using the `ci` command for a monorepo, where credentials are injected per project from `INTLAYER_PROJECT_CREDENTIALS`.
-
-> **AI access**: The `fill` command needs AI access to generate translations. The credentials injected by `ci` from `INTLAYER_PROJECT_CREDENTIALS` (Intlayer CMS access keys) grant AI access through the Intlayer backend, so no separate AI provider key is required. If you prefer to use your own provider key instead, pass `--provider`, `--model`, and `--api-key` to `intlayer ci fill`. The `test` command does not require AI access.
-
-```yaml fileName=".github/workflows/intlayer-ci.yml"
-name: Intlayer CI
-
-on:
-  pull_request:
-    branches:
-      - main
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  intlayer:
-    runs-on: ubuntu-latest
-    env:
-      # CMS access keys per project. They also grant AI access for `fill`.
-      INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
-    steps:
-      - name: ⬇️ Checkout repository
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: true
-          fetch-depth: 0
-
-      - name: 🟢 Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: 📦 Install dependencies
-        run: npm ci
-
-      - name: 🤖 Fill missing translations
-        run: npx intlayer ci fill --git-diff --mode complete
-
-      - name: 🧪 Test for missing translations
-        run: npx intlayer ci test
-```
-
-## Scaffolded GitHub Actions
-
-When you run `intlayer init`, Intlayer detects your package manager (npm, yarn, pnpm, or bun) and scaffolds two GitHub Actions workflows under `.github/workflows/`, with commands matching that package manager:
-
-- **`intlayer-fill.yml`** — On every pull request, builds the dictionaries and runs `intlayer fill --git-diff --mode complete` to generate missing translations for the changed dictionaries, then commits the result back to the PR branch.
-- **`intlayer-test.yml`** — On every pull request, builds the dictionaries and runs `intlayer test`, failing the check when required locales are missing translations.
-
-Existing workflow files are never overwritten. To skip scaffolding entirely, run:
-
-```bash
-npx intlayer init --no-github-actions
-```
-
-### Providing AI access to the fill workflow
-
-The scaffolded `intlayer-fill.yml` requires AI access. Two options are available (configured in the workflow's `env` block):
-
-1. **Your own AI provider key** — Add an `AI_API_KEY` secret in your repository settings (Settings → Secrets and variables → Actions). The workflow forwards it via `--provider`, `--model`, and `--api-key`.
-2. **Intlayer CMS access keys** — Add `INTLAYER_CLIENT_ID` and `INTLAYER_CLIENT_SECRET` secrets and wire them into your `intlayer.config` `editor` section. CMS access keys grant AI access through the Intlayer backend.
-
-The `intlayer-test.yml` workflow does not require any AI access.
-
-## Error Handling
-
-- If `INTLAYER_PROJECT_CREDENTIALS` is not set, the command will exit with an error.
-- If `INTLAYER_PROJECT_CREDENTIALS` is not valid JSON, the command will exit with an error.
-- If a project path doesn't exist, it will be skipped with a warning.
-- If any project fails, the command will exit with a non-zero status code.
-
-## Use Cases
-
-- **Monorepo automation**: Run Intlayer commands across multiple projects in a monorepo
-- **CI/CD pipelines**: Automate dictionary management in continuous integration workflows
-- **Bulk operations**: Perform the same operation on multiple Intlayer projects at once
-- **Secret management**: Securely manage credentials for multiple projects using environment variables
-
-## Security Best Practices
-
-- Store `INTLAYER_PROJECT_CREDENTIALS` as encrypted secrets in your CI/CD platform
-- Never commit credentials to version control
-- Use environment-specific credentials for different deployment environments
-- Rotate credentials regularly