@enformik/cli 0.5.0 → 0.6.0

package/README.md

@@ -1,63 +1,104 @@
 # @enformik/cli
 
-Enformik geliştirici CLI'si: kendi derlediğiniz **web sitesini** yayınlar ve **uygulama modülünüzü (şema)** yükseltir. CI/CD hatlarında çalışmak için tasarlanmıştır; çalışma zamanı bağımlılığı yoktur (Node.js ≥ 20).
+The Enformik developer CLI: publishes the **website** you build and upgrades your **application module (schema)**. It is designed to run in CI/CD pipelines and has no runtime dependencies (Node.js ≥ 20).
 
 ```bash
 npx @enformik/cli --help
-# ya da kalıcı kurulum:
-npm install -g @enformik/cli   # komut: enformik
+# or install it permanently:
+npm install -g @enformik/cli   # command: enformik
 ```
 
-## Site dağıtımı
+## Site deployment
 
-Gerekenler: Enformik yönetim konsolunda web sitesi ortamınızda **Geliştirici sitesi** etkin ve bir **dağıtım anahtarı** oluşturulmuş olmalı.
+Requirements: in the Enformik management console, **Developer site** must be enabled on your website environment and a **deploy key** must have been created.
 
 ```bash
-export ENFORMIK_CONSOLE_URL=https://<konsol-adresiniz>
-export ENFORMIK_DEPLOY_KEY=enf_dk_…        # CI gizli değişkeni; depoya yazmayın
+export ENFORMIK_CONSOLE_URL=https://<your-console-url>
+export ENFORMIK_DEPLOY_KEY=enf_dk_…        # CI secret variable; do not commit it to the repo
 
 npx @enformik/cli site deploy --dir dist
 ```
 
-`index.html` kökte mi, gizli dosya (`.env`, `.git`…) var mı, dosya türleri izinli mi (çalıştırılabilir dosya, `.zip`/`.iso` ve uzantısız dosya reddedilir), boyut/kota uygun mu gibi kurallar **yüklemeden önce** denetlenir; hatalar dosya yoluyla gösterilir. Paketteki metin dosyalarında sır bulunursa yükleme durur; yanlış alarmı proje kökündeki `.enformikignore` dosyasına (satır başına bir yol, `dizin/` öneki, joker yok) yazarak atlayabilirsiniz. `--expect-host <site-adresi>` yanlış siteye dağıtımı engeller. Başarıda yeni sürümün adresi yazdırılır.
+Rules such as whether `index.html` is at the root, whether there are hidden files (`.env`, `.git`…), whether the file types are allowed (executables, `.zip`/`.iso` and files without an extension are rejected), and whether the size/quota fits are checked **before uploading**; errors are shown with the file path. If a text file in the bundle contains a secret, the upload stops; you can skip a false alarm by listing the file in `.enformikignore` in the project root (one path per line, `dir/` prefix, no wildcards). `--expect-host <site-host>` prevents deploying to the wrong site. On success the address of the new release is printed.
 
-## Şema (modül) yükseltme
+## Schema (module) upgrades
 
-Gerekenler: uygulamanızda **Şema yükseltici** (yalnızca yükseltme), **Şema oluşturucu** (yükseltme + ilk kurulum) ya da Yönetici rolünde bir **API istemcisi** (konsol → **API Anahtarları** sayfası). Modülün ilk kurulumu `schema install` ile (Şema oluşturucu/Yönetici), sonraki yükseltmeler `schema push` ile yapılır.
+Requirements: an **API client** in your application with the **Schema upgrader** role (upgrades only), the **Schema builder** role (upgrades + first installation), or the Administrator role (console → **API Keys** page). The first installation of a module is done with `schema install` (Schema builder/Administrator); later upgrades are done with `schema push`.
 
 ```bash
-export ENFORMIK_APP_URL=https://<uygulama-adresiniz>
+export ENFORMIK_APP_URL=https://<your-app-url>
 export ENFORMIK_CLIENT_ID=apic-…
 export ENFORMIK_CLIENT_SECRET=…
 
-npx @enformik/cli schema install --manifest module.json --yes  # modülün ilk kurulumu (--dry-run: yalnızca göster)
-npx @enformik/cli schema diff --manifest module.json --check   # değişiklik varsa çıkış kodu 2
+npx @enformik/cli schema install --manifest module.json --yes  # first installation of the module (--dry-run: show only)
+npx @enformik/cli schema diff --manifest module.json --check   # exit code 2 if there are changes
 npx @enformik/cli schema push --manifest module.json --yes
 ```
 
-> **Dikkat:** modül (şema) değişikliği uygulamanın **tüm çalışma alanlarını** etkiler. Canlı uygulamaya laptop'tan değil, CI'dan ve canlıya özel bir istemci ile uygulayın.
+> **Warning:** a module (schema) change affects **all workspaces** in the application. Apply it to a live application from CI with a client dedicated to production, not from a laptop.
 
-"Şema yükseltici" ve "Şema oluşturucu" rolleri betik, otomasyon, yetki tanımı, veri kaynağı, etkileşimli sayfa, arayüz uzantısı ve tohum veri içeren manifestleri ve alan türü değişikliklerini uygulayamaz; bunlar bir yönetici tarafından uygulanır.
+The "Schema upgrader" and "Schema builder" roles cannot apply manifests that contain scripts, automations, permission definitions, data sources, interactive pages, UI extensions or seed data, nor field type changes; an administrator applies these.
 
-## Komutlar
+## Commands
 
-| Komut | Açıklama |
+| Command | Description |
 | --- | --- |
-| `link` | `.enformik/config.json` yazar (adresler; **sır içermez**) |
-| `whoami` | Hangi kimlikle, hangi hedefe bağlanıldığını gösterir |
-| `schema diff` | Manifesti uygulamadakiyle karşılaştırır (`--check`) |
-| `schema push` | Değişiklikleri uygular (etkileşimsiz ortamda `--yes` zorunlu) |
-| `site deploy` | Derlenmiş siteyi yayınlar (`--dir`, `--no-wait`, `--timeout`, `--expect-host`) |
-| `site status` | Hedef site ve canlı sürüm bilgisi (`--expect-host`) |
+| `link` | Writes `.enformik/config.json` (URLs only; **contains no secrets**) |
+| `whoami` | Shows which identity connects to which target |
+| `ai init` | Downloads the AI agent guides into `.enformik/ai/` and adds an instruction block to `AGENTS.md` (`--lang en\|tr`, default `en`; `--offline`) |
+| `app check` | Read-only check of the web app's integration health: site sign-in, module version, record access rules, web user access (`--entity`, `--expect-host`) |
+| `codegen` | Generates TypeScript types and a typed data client from `module.json` (`--out`, `--check`) |
+| `schema validate` | Validates the manifest with the server's rules without touching the data (`--profile ai`, `--offline`) |
+| `schema diff` | Compares the manifest with the one in the application (`--check`) |
+| `schema install` | Installs the module for the first time (`--dry-run`, `--yes`; role: Schema builder) |
+| `schema push` | Applies changes (`--yes` is required in non-interactive environments) |
+| `site deploy` | Publishes the built site (`--dir`, `--no-wait`, `--timeout`, `--expect-host`) |
+| `site status` | Shows the target site and the live release (`--expect-host`) |
 
-Genel bayraklar: `--json` (stdout'a yalnızca JSON; insan çıktısı stderr'e), `--config`, `--debug`.
-Çıkış kodları: `0` başarı · `1` hata · `2` (`--check`) uygulanacak değişiklik var.
-`--expect-host <ad>` (şema komutları): hedef uygulamanın ana makine adı farklıysa işlemi durdurur (yanlış uygulamaya push'a karşı koruma).
+Run `enformik <command> --help` for a command's usage. A mistyped command (`enformik sitee --help`) is an error, not the general help.
 
-## Güvenlik
+Global flags: `--json`, `--config`, `--debug`, `-h`/`--help`, `-v`/`--version`.
 
-- Sırlar **yalnızca ortam değişkeniyle** verilir; komut satırı bayrağı veya yapılandırma dosyası yoktur (sır içeren `.enformik/config.json` reddedilir).
-- Kimlik bilgileri yalnızca HTTPS ile gönderilir (`localhost` hariç); yönlendirmeler takip edilmez.
-- Erişim belirteci yalnızca bellekte tutulur.
+`--expect-host <host>` stops the operation if the host name differs. In the schema commands and in `app check` it is the **application's** host (in `app check` it is checked before any request is sent; the site side is not checked against it); in `site deploy` and `site status` it is the **site's** host.
 
-Ayrıntılı rehber: Enformik geliştirici dokümantasyonunda "CLI" sayfası.
+## Exit codes
+
+| Code | Meaning |
+| --- | --- |
+| `0` | Success (including no-ops, `--dry-run` and `--no-wait`) |
+| `1` | Error: invalid input, validation, credentials, server error, failed deployment, a declined confirmation (a closed input counts as "no"), a rate limit |
+| `2` | Not an error: `schema diff --check` found changes to apply, `codegen --check` found the file out of date, or `app check` found warnings only |
+
+## JSON output
+
+With `--json`, stdout carries **only** JSON (human-readable text goes to stderr), so pipelines can parse it. Errors are JSON objects with `error` (a stable code) and `message`, for example `unknown_command`, `usage`, `no_credentials` (`whoami`, with the list of what is required), `rate_limited` (with `status: 429` and, when the server sent one, `retryAfterSeconds`; the CLI does not retry a 429 by itself) or `unexpected`. Some commands report a failed outcome as their normal result instead (a declined confirmation is `applied: false`, a failed or rejected deployment is `deployed: false` with `status`, `error` or `issues`, `app check` lists its `failures`); in every case the exit code is `1`, so branch on the exit code first and read `error` second.
+
+## Environment variables
+
+| Variable | Used for |
+| --- | --- |
+| `ENFORMIK_CONSOLE_URL`, `ENFORMIK_DEPLOY_KEY` | Site deployment (`site deploy`, `site status`, `app check`, `whoami`) |
+| `ENFORMIK_APP_URL`, `ENFORMIK_CLIENT_ID`, `ENFORMIK_CLIENT_SECRET` | Schema commands, `app check`, `whoami` |
+| `ENFORMIK_WORKSPACE_ID` | Workspace to use (otherwise the app's default) |
+| `ENFORMIK_DOCS_URL` | Where `ai init` downloads the guides from (default `https://help.enformik.com`) |
+
+The URLs can also be saved with `enformik link`; precedence is flag, then environment variable, then `.enformik/config.json`. Secrets are never read from a flag or the config file.
+
+## Upgrading from 0.5
+
+- All output (help, errors, generated file text) is in English; it used to be Turkish. This includes the `message` strings in `--json` output, so a parser that matched Turkish text must be updated (match the stable `error` code instead).
+- `ai init --lang` now defaults to `en` (it was `tr`); pass `--lang tr` for the Turkish guide. Files of the other language already in `.enformik/ai/` are left in place.
+- The confirmation prompt is `[y/N]` and accepts only `y` or `yes` (it was `[e/H]` and also accepted `e` and `evet`). If the input closes before an answer, that counts as "no": the command stops with exit code `1` instead of ending silently. A CI script that piped `e` or `evet` into `schema push` now gets exit code `1` and nothing is applied; pass `--yes` instead.
+- `whoami --json` without credentials prints a `no_credentials` JSON error instead of nothing.
+- A rate limit (HTTP 429) is reported as `Rate limited by the server; retry in about N s.` (and as `rate_limited` in JSON); there is no automatic retry.
+- A mistyped command with `--help` (`enformik sitee --help`) is now an `unknown_command` error with exit code `1`; it used to print the general help and exit `0`.
+- `app check --expect-host` checks the application host before any request is sent; the site side ignores it.
+- If the reply to a deployment's `finalize` is lost, the CLI now reads the deployment's real state and carries on instead of reporting a failure.
+
+## Security
+
+- Secrets are provided **only through environment variables**; there is no command-line flag or config file for them (a `.enformik/config.json` that contains a secret is rejected).
+- Credentials are sent only over HTTPS (except `localhost`); redirects are not followed.
+- The access token is kept in memory only.
+
+Detailed guide: the "CLI" page in the Enformik developer documentation.

package/dist/auth.js

@@ -1,21 +1,23 @@
 import { ApiError, CliError } from './errors.js';
-import { assertSecureUrl, ensureOk, joinUrl, request } from './http.js';
+import { assertSecureUrl, ensureOk, joinUrl, rateLimitedError, request } from './http.js';
 export async function discoverApp(appUrl, version, fetchImpl) {
-    assertSecureUrl(appUrl, 'Uygulama adresi');
+    assertSecureUrl(appUrl, 'App URL');
     const res = await request(joinUrl(appUrl, '/api/config'), { retries: 2, headers: { 'X-Enformik-CLI-Version': version }, fetchImpl });
     try {
         ensureOk(res);
     }
     catch (e) {
+        if (e instanceof ApiError && e.status === 429)
+            throw e;
         if (e instanceof ApiError)
-            throw new CliError(`Uygulama yapılandırması okunamadı (HTTP ${e.status}). Adres doğru mu: ${appUrl}?`);
+            throw new CliError(`Could not read the app configuration (HTTP ${e.status}). Is the URL correct: ${appUrl}?`);
         throw e;
     }
     const j = (res.json ?? {});
     if (!j.oidc_authority)
-        throw new CliError('Uygulama yapılandırması beklenen biçimde değil (oidc_authority yok).');
+        throw new CliError('The app configuration is not in the expected format (oidc_authority is missing).');
     if (!j.api_audience) {
-        throw new CliError('Bu uygulama API istemcisi belirteçlerini kabul etmiyor (api_audience boş). Destek kaydı açın.');
+        throw new CliError('This app does not accept API client tokens (api_audience is empty). Open a support ticket.');
     }
     return { oidcAuthority: j.oidc_authority, apiAudience: j.api_audience, tenantId: j.tenant_id ?? '' };
 }
@@ -24,7 +26,7 @@ export function buildScope(audience) {
 }
 export async function fetchAccessToken(app, clientId, clientSecret, version, fetchImpl) {
     const url = joinUrl(app.oidcAuthority, '/oauth/v2/token');
-    assertSecureUrl(url, 'Kimlik sağlayıcı adresi');
+    assertSecureUrl(url, 'Identity provider URL');
     const res = await request(url, {
         method: 'POST',
         headers: {
@@ -38,13 +40,15 @@ export async function fetchAccessToken(app, clientId, clientSecret, version, fet
     });
     if (!res.ok) {
         if (res.status === 400 || res.status === 401) {
-            throw new CliError('Kimlik doğrulanamadı: istemci kimliği/sırrı geçersiz ya da istemci iptal edilmiş. Konsoldan sırrı yenileyin.');
+            throw new CliError('Authentication failed: the client ID/secret is invalid or the client has been revoked. Regenerate the secret in the console.');
         }
-        throw new CliError(`Belirteç alınamadı (HTTP ${res.status}).`);
+        if (res.status === 429)
+            throw rateLimitedError(res);
+        throw new CliError(`Could not obtain a token (HTTP ${res.status}).`);
     }
     const j = res.json;
     if (!j?.access_token)
-        throw new CliError('Kimlik sağlayıcı beklenen yanıtı vermedi (access_token yok).');
+        throw new CliError('The identity provider did not return the expected response (access_token is missing).');
     return { token: j.access_token, expiresInSec: j.expires_in ?? 0, claims: decodeJwtPayload(j.access_token) };
 }
 /** İmza DOĞRULANMAZ (yalnızca whoami'de bilgi göstermek için); yetkilendirme sunucuda yapılır. */

package/dist/cli.js

@@ -25,45 +25,45 @@ const OPTIONS = {
 };
 const GLOBAL = ['json', 'help', 'version', 'debug', 'config'];
 export const COMMANDS = {
-    link: { flags: ['console-url', 'app-url', 'workspace', 'module', 'manifest', 'dir', 'no-verify'], run: link, usage: 'enformik link [--console-url U] [--app-url U] [--workspace ID] [--module SLUG] [--manifest YOL] [--dir KLASÖR]' },
+    link: { flags: ['console-url', 'app-url', 'workspace', 'module', 'manifest', 'dir', 'no-verify'], run: link, usage: 'enformik link [--console-url U] [--app-url U] [--workspace ID] [--module SLUG] [--manifest PATH] [--dir DIR]' },
     whoami: { flags: ['console-url', 'app-url', 'workspace'], run: whoami, usage: 'enformik whoami' },
-    'ai init': { flags: ['lang', 'docs-url', 'offline'], run: aiInit, usage: 'enformik ai init [--lang tr|en] [--docs-url URL] [--offline]' },
-    'app check': { flags: ['console-url', 'app-url', 'workspace', 'module', 'manifest', 'entity', 'expect-host'], run: appCheck, usage: 'enformik app check [--entity a,b] [--manifest module.json]' },
+    'ai init': { flags: ['lang', 'docs-url', 'offline'], run: aiInit, usage: 'enformik ai init [--lang en|tr] [--docs-url URL] [--offline]' },
+    'app check': { flags: ['console-url', 'app-url', 'workspace', 'module', 'manifest', 'entity', 'expect-host'], run: appCheck, usage: 'enformik app check [--entity a,b] [--manifest module.json] [--expect-host <app-host>]  (--expect-host checks the app host only)' },
     codegen: { flags: ['manifest', 'out', 'check'], run: codegen, usage: 'enformik codegen [--manifest module.json] [--out src/enformik.generated.ts] [--check]' },
     'schema diff': { flags: ['app-url', 'workspace', 'module', 'manifest', 'check', 'seed-data', 'expect-host'], run: schemaDiff, usage: 'enformik schema diff [--manifest module.json] [--check]' },
     'schema validate': { flags: ['app-url', 'workspace', 'module', 'manifest', 'seed-data', 'expect-host', 'profile', 'offline'], run: schemaValidate, usage: 'enformik schema validate [--manifest module.json] [--profile import|ai] [--offline]' },
     'schema install': { flags: ['app-url', 'workspace', 'module', 'manifest', 'yes', 'dry-run', 'seed-data', 'expect-host'], run: schemaInstall, usage: 'enformik schema install [--manifest module.json] [--yes] [--dry-run]' },
     'schema push': { flags: ['app-url', 'workspace', 'module', 'manifest', 'yes', 'seed-data', 'expect-host'], run: schemaPush, usage: 'enformik schema push [--manifest module.json] [--yes] [--seed-data]' },
-    'site deploy': { flags: ['console-url', 'dir', 'no-wait', 'timeout', 'expect-host'], run: siteDeploy, usage: 'enformik site deploy [--dir dist] [--no-wait] [--timeout 600] [--expect-host <site-adresi>]' },
-    'site status': { flags: ['console-url', 'expect-host'], run: siteStatus, usage: 'enformik site status [--expect-host <site-adresi>]' },
+    'site deploy': { flags: ['console-url', 'dir', 'no-wait', 'timeout', 'expect-host'], run: siteDeploy, usage: 'enformik site deploy [--dir dist] [--no-wait] [--timeout 600] [--expect-host <site-host>]' },
+    'site status': { flags: ['console-url', 'expect-host'], run: siteStatus, usage: 'enformik site status [--expect-host <site-host>]' },
 };
 export function helpText(version) {
-    return `enformik ${version} — Enformik geliştirici CLI'si
+    return `enformik ${version} — the Enformik developer CLI
 
-Kullanım: enformik <komut> [bayraklar]
+Usage: enformik <command> [flags]
 
-Komutlar
-  link          .enformik/config.json yazar (adresler; sır içermez)
-  whoami        Hangi kimlikle, hangi hedefe bağlanıldığını gösterir
-  ai init       Yapay zekâ ajanı rehberlerini sunucudan çeker (.enformik/ai/) ve AGENTS.md'ye talimat bloğu ekler
-  app check     Web uygulamasının entegrasyon sağlığını denetler (site girişi, modül, web kullanıcısı erişimi; çıkış 1 sorun, 2 uyarı)
-  codegen       module.json'dan TypeScript tipleri + tipli veri istemcisi üretir (--check: güncel değilse çıkış 2)
-  schema validate  Manifesti DB'ye dokunmadan doğrular (--profile ai: eksiksizlik; --offline: yalnızca yerel)
-  schema diff   Modül manifestini uygulamadakiyle karşılaştırır (--check: değişiklik varsa çıkış kodu 2)
-  schema install  Modülü uygulamaya İLK kez kurar (rol: Şema oluşturucu; --dry-run yalnızca gösterir)
-  schema push   Değişiklikleri uygular (etkileşimsiz ortamda --yes gerekir)
-  site deploy   Derlenmiş siteyi (varsayılan: dist) web sitesi ortamına yayınlar
-  site status   Hedef site ve canlı sürüm bilgisi
+Commands
+  link          Writes .enformik/config.json (URLs only; no secrets)
+  whoami        Shows which identity connects to which target
+  ai init       Downloads the AI agent guides from the server (.enformik/ai/) and adds an instruction block to AGENTS.md
+  app check     Checks the web app's integration health (site sign-in, module, web user access; exit 1 = problem, 2 = warning)
+  codegen       Generates TypeScript types + a typed data client from module.json (--check: exit 2 if out of date)
+  schema validate  Validates the manifest without touching the DB (--profile ai: completeness; --offline: local only)
+  schema diff   Compares the module manifest with the one in the app (--check: exit code 2 if there are changes)
+  schema install  Installs the module into the app for the FIRST time (role: Schema builder; --dry-run only shows)
+  schema push   Applies changes (--yes is required in non-interactive environments)
+  site deploy   Publishes the built site (default: dist) to the website environment
+  site status   Shows the target site and the live version
 
-Genel bayraklar: --json (makine-okunur çıktı), --config YOL, --debug, -h/--help, -v/--version
+Global flags: --json (machine-readable output), --config PATH, --debug, -h/--help, -v/--version
 
-Sırlar yalnızca ortam değişkeniyle verilir:
-  Şema yükseltme : ENFORMIK_CLIENT_ID, ENFORMIK_CLIENT_SECRET   (+ ENFORMIK_APP_URL)
-  Site dağıtımı  : ENFORMIK_DEPLOY_KEY                          (+ ENFORMIK_CONSOLE_URL)
+Secrets are provided only through environment variables:
+  Schema upgrade : ENFORMIK_CLIENT_ID, ENFORMIK_CLIENT_SECRET   (+ ENFORMIK_APP_URL)
+  Site deployment: ENFORMIK_DEPLOY_KEY                          (+ ENFORMIK_CONSOLE_URL)
 
-Çıkış kodları: 0 başarı · 1 hata · 2 (--check) uygulanacak değişiklik var
+Exit codes: 0 success · 1 error · 2 changes pending (--check) or warnings only (app check)
 
-Ayrıntılar: komut yardımı için "enformik <komut> --help"`;
+Details: run "enformik <command> --help" for command help`;
 }
 function readVersion() {
     try {
@@ -82,7 +82,7 @@ export async function main(d) {
     catch (e) {
         // Ayrıştırma başarısız olduğu için --json değeri yok; ham argümandan anlaşılır (CAP-9: JSON kipinde stdout JSON).
         const out = createOutput({ json: d.argv.includes('--json'), stderr: d.stderr, stdout: d.stdout, env: d.env });
-        out.error(`${e.message}\n"enformik --help" ile kullanımı görün.`);
+        out.error(`${e.message}\nRun "enformik --help" for usage.`);
         out.result({ error: 'usage', message: e.message });
         return 1;
     }
@@ -97,37 +97,41 @@ export async function main(d) {
     const find = (k) => (Object.hasOwn(COMMANDS, k) ? COMMANDS[k] : undefined);
     const cmd = find(name) ?? find(positionals[0] ?? '');
     const cmdName = find(name) ? name : positionals[0] ?? '';
-    if (values.help || positionals.length === 0 || positionals[0] === 'help') {
+    // "enformik <typo> --help" is an error, not the general help; a command prefix ("schema --help") still shows the help.
+    const first = positionals[0];
+    const isPrefix = first !== undefined && Object.keys(COMMANDS).some((k) => k.startsWith(first + ' '));
+    const unknownWithHelp = values.help === true && first !== undefined && first !== 'help' && !cmd && (positionals.length >= 2 || !isPrefix);
+    if (!unknownWithHelp && (values.help || positionals.length === 0 || positionals[0] === 'help')) {
         if (cmd && values.help) {
-            out.info(`Kullanım: ${cmd.usage}`);
+            out.info(`Usage: ${cmd.usage}`);
             return 0;
         }
         out.info(helpText(d.version));
         return positionals.length === 0 && !values.help ? 1 : 0;
     }
     if (!cmd) {
-        out.error(`Bilinmeyen komut: ${positionals.join(' ')}\n"enformik --help" ile komutları görün.`);
-        out.result({ error: 'unknown_command', message: `Bilinmeyen komut: ${positionals.join(' ')}` });
+        out.error(`Unknown command: ${positionals.join(' ')}\nRun "enformik --help" to see the commands.`);
+        out.result({ error: 'unknown_command', message: `Unknown command: ${positionals.join(' ')}` });
         return 1;
     }
     const used = Object.entries(values).filter(([, v]) => v !== undefined).map(([k]) => k);
     const bad = used.filter((k) => !GLOBAL.includes(k) && !cmd.flags.includes(k));
     if (bad.length > 0) {
-        out.error(`"${cmdName}" komutunda geçersiz bayrak: ${bad.map((b) => '--' + b).join(', ')}\nKullanım: ${cmd.usage}`);
-        out.result({ error: 'usage', message: `"${cmdName}" komutunda geçersiz bayrak: ${bad.map((b) => '--' + b).join(', ')}` });
+        out.error(`Invalid flag for "${cmdName}": ${bad.map((b) => '--' + b).join(', ')}\nUsage: ${cmd.usage}`);
+        out.result({ error: 'usage', message: `Invalid flag for "${cmdName}": ${bad.map((b) => '--' + b).join(', ')}` });
         return 1;
     }
     const extra = positionals.slice(cmdName.split(' ').length);
     if (extra.length > 0) {
-        out.error(`Beklenmeyen argüman: ${extra.join(' ')}\nKullanım: ${cmd.usage}`);
-        out.result({ error: 'usage', message: `Beklenmeyen argüman: ${extra.join(' ')}` });
+        out.error(`Unexpected argument: ${extra.join(' ')}\nUsage: ${cmd.usage}`);
+        out.result({ error: 'usage', message: `Unexpected argument: ${extra.join(' ')}` });
         return 1;
     }
     try {
         const { config } = loadConfig(d.cwd, typeof values.config === 'string' ? values.config : undefined);
         const flags = values;
         const settings = resolveSettings(config, d.env, flags);
-        const prompts = realPrompts();
+        const prompts = realPrompts(d.stdin);
         const ctx = {
             out, settings, flags, cwd: d.cwd, env: d.env, version: d.version,
             isTTY: d.isTTY ?? !!process.stdin.isTTY,
@@ -144,12 +148,17 @@ export async function main(d) {
             out.result({ error: e.code ?? 'error', message: e.message });
             return e.exitCode;
         }
+        if (e instanceof ApiError && e.status === 429) {
+            out.error(e.message);
+            out.result({ error: e.code ?? 'rate_limited', message: e.message, status: 429, ...(e.retryAfterSeconds !== undefined ? { retryAfterSeconds: e.retryAfterSeconds } : {}) });
+            return 1;
+        }
         if (e instanceof ApiError) {
-            out.error(`Sunucu hatası (HTTP ${e.status}): ${e.message}`);
+            out.error(`Server error (HTTP ${e.status}): ${e.message}`);
             out.result({ error: e.code ?? 'api_error', message: e.message, status: e.status });
             return 1;
         }
-        out.error(`Beklenmeyen hata: ${e.message}`);
+        out.error(`Unexpected error: ${e.message}`);
         out.result({ error: 'unexpected', message: e.message });
         if (values.debug)
             out.error(e.stack ?? '');
@@ -165,5 +174,5 @@ catch {
     return p;
 } }
 if (invoked && invoked === fileURLToPath(import.meta.url)) {
-    main({ argv: process.argv.slice(2), env: process.env, cwd: process.cwd(), version: readVersion() }).then((code) => { process.exitCode = code; }, (e) => { process.stderr.write(`Beklenmeyen hata: ${e.message}\n`); process.exitCode = 1; });
+    main({ argv: process.argv.slice(2), env: process.env, cwd: process.cwd(), version: readVersion() }).then((code) => { process.exitCode = code; }, (e) => { process.stderr.write(`Unexpected error: ${e.message}\n`); process.exitCode = 1; });
 }

package/dist/codegen.js

@@ -56,15 +56,15 @@ export function generateClient(manifest) {
     const m = manifest.module ?? {};
     const entities = (manifest.entities ?? []).filter((e) => e && typeof e.slug === 'string');
     const out = [];
-    out.push(`// Bu dosya \`enformik codegen\` ile ${m.slug ?? 'modül'}@${m.version ?? '?'} manifestinden ÜRETİLDİ — elle düzenlemeyin.`);
-    out.push('// Yeniden üretmek için: npx @enformik/cli codegen   (CI: codegen --check)');
+    out.push(`// This file was GENERATED by \`enformik codegen\` from the ${m.slug ?? 'module'}@${m.version ?? '?'} manifest — do not edit by hand.`);
+    out.push('// To regenerate: npx @enformik/cli codegen   (CI: codegen --check)');
     out.push('');
-    out.push('/** @enformik/auth istemcisinin bu dosyanın ihtiyaç duyduğu parçası. */');
+    out.push('/** The part of the @enformik/auth client that this file needs. */');
     out.push('export interface EnformikAuthLike { fetch(path: string, init?: RequestInit): Promise<Response> }');
     out.push('');
     out.push('export class EnformikApiError extends Error {');
     out.push('  constructor(public readonly status: number, public readonly body: unknown) {');
-    out.push("    super(`Enformik API hatası (HTTP ${status})`);");
+    out.push("    super(`Enformik API error (HTTP ${status})`);");
     out.push("    this.name = 'EnformikApiError';");
     out.push('  }');
     out.push('}');
@@ -73,7 +73,7 @@ export function generateClient(manifest) {
     out.push('export interface ListOptions<R> {');
     out.push('  page?: number; limit?: number; search?: string;');
     out.push("  sort?: keyof R & string; sortDir?: 'ASC' | 'DESC';");
-    out.push('  /** Alan adı → değer eşitlik/içerir filtresi. */');
+    out.push('  /** Field name -> value equality/contains filter. */');
     out.push('  filter?: Partial<Record<keyof R & string, string | number | boolean>>;');
     out.push('}');
     out.push('');
@@ -99,7 +99,7 @@ export function generateClient(manifest) {
         out.push(`export type ${T}Patch = Partial<${T}Input>;`);
         out.push('');
     }
-    out.push('/** Tipli veri istemcisi: `const api = createClient(auth); await api.xyz.list({ limit: 20 })`. */');
+    out.push('/** Typed data client: `const api = createClient(auth); await api.xyz.list({ limit: 20 })`. */');
     out.push('export function createClient(auth: EnformikAuthLike) {');
     out.push('  async function call<T>(method: string, path: string, body?: unknown): Promise<{ data: T; res: Response }> {');
     out.push("    const res = await auth.fetch(path, { method, headers: body === undefined ? undefined : { 'Content-Type': 'application/json' }, body: body === undefined ? undefined : JSON.stringify(body) });");

package/dist/commands/ai.js

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { CliError } from '../errors.js';
-import { assertSecureUrl, joinUrl, request } from '../http.js';
+import { assertSecureUrl, joinUrl, rateLimitedError, request } from '../http.js';
 export const DEFAULT_DOCS_URL = 'https://help.enformik.com';
 const MAX_FILE_BYTES = 2 * 1024 * 1024;
 const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*(\/[A-Za-z0-9][A-Za-z0-9._-]*)*$/;
@@ -20,7 +20,7 @@ export function cmpVersion(a, b) {
 function parseIndex(raw) {
     const x = raw;
     if (!x || x.schemaVersion !== 1 || typeof x.guideVersion !== 'string' || !x.files || !x.shared || !Array.isArray(x.languages)) {
-        throw new CliError('Rehber dizini (index.json) beklenen biçimde değil; CLI\'yi güncelleyin ya da daha sonra yeniden deneyin.');
+        throw new CliError('The guide index (index.json) is not in the expected format; update the CLI or try again later.');
     }
     return x;
 }
@@ -59,75 +59,79 @@ export function upsertBlock(existing, block) {
     if (s >= 0) {
         const e = existing.indexOf(END, s);
         if (e < 0)
-            throw new CliError(`Talimat bloğunun başlangıç işaretçisi var ama bitiş işaretçisi (${END}) yok; dosya bozulmuş görünüyor. Dosyaya dokunulmadı: işaretçiyi onarın ya da bloğu elle silip yeniden çalıştırın.`);
+            throw new CliError(`The instruction block has a start marker but no end marker (${END}); the file looks corrupted. The file was not modified: repair the marker, or delete the block by hand and run again.`);
         return existing.slice(0, s) + block + existing.slice(e + END.length).replace(/^\n/, '');
     }
     return existing.replace(/\n*$/, '\n\n') + block;
 }
 async function download(base, rel, sha, ctx) {
     if (!SAFE_NAME.test(rel) || rel.includes('..'))
-        throw new CliError(`Rehber dizininde güvensiz dosya adı: ${rel}`);
+        throw new CliError(`Unsafe file name in the guide index: ${rel}`);
     const res = await request(joinUrl(base, rel), { retries: 2, fetchImpl: ctx.fetchImpl, headers: { 'X-Enformik-CLI-Version': ctx.version } });
+    if (res.status === 429)
+        throw rateLimitedError(res);
     if (!res.ok)
-        throw new CliError(`Rehber dosyası indirilemedi: ${rel} (HTTP ${res.status}).`);
+        throw new CliError(`Could not download guide file: ${rel} (HTTP ${res.status}).`);
     if (Buffer.byteLength(res.text) > MAX_FILE_BYTES)
-        throw new CliError(`Rehber dosyası beklenenden büyük: ${rel}.`);
+        throw new CliError(`Guide file is larger than expected: ${rel}.`);
     if (createHash('sha256').update(res.text).digest('hex') !== sha) {
-        throw new CliError(`Rehber dosyasının sağlama toplamı uyuşmuyor: ${rel} (indirme bozulmuş ya da yayın yarım kalmış olabilir; yeniden deneyin).`);
+        throw new CliError(`Checksum mismatch for guide file: ${rel} (the download may be corrupted or the release incomplete; try again).`);
     }
     return res.text;
 }
 /**
- * enformik ai init [--lang tr|en] [--docs-url URL] [--offline]
- * Yapay zekâ ajanı rehberlerini Enformik dokümantasyon sitesinden (sunucudan) çeker, sağlama toplamlarını doğrular,
- * `.enformik/ai/` altına yazar ve AGENTS.md'ye (varsa CLAUDE.md'ye de) kısa bir talimat bloğu ekler. Sır yazmaz.
+ * enformik ai init [--lang en|tr] [--docs-url URL] [--offline]
+ * Downloads the AI agent guides from the Enformik documentation site, verifies checksums,
+ * writes them under `.enformik/ai/` and adds a short instruction block to AGENTS.md (and CLAUDE.md if present). Writes no secrets.
  */
 export async function aiInit(ctx) {
     const { out } = ctx;
-    const lang = ctx.flags.lang === undefined ? 'tr' : ctx.flags.lang;
+    const lang = ctx.flags.lang === undefined ? 'en' : ctx.flags.lang;
     if (lang !== 'tr' && lang !== 'en')
-        throw new CliError(`--lang "tr" ya da "en" olmalı (verilen: ${String(lang)}).`);
+        throw new CliError(`--lang must be "en" or "tr" (got: ${String(lang)}).`);
     const root = resolve(ctx.cwd, '.enformik', 'ai');
     let index;
     let source = 'server';
     if (ctx.flags.offline === true) {
         const cached = join(root, 'index.json');
         if (!existsSync(cached))
-            throw new CliError('Önbellekte rehber yok. Önce çevrimiçi `enformik ai init` çalıştırın.');
+            throw new CliError('No guide in the cache. Run `enformik ai init` online first.');
         let raw;
         try {
             raw = JSON.parse(readFileSync(cached, 'utf8'));
         }
         catch {
-            throw new CliError('Önbellekteki rehber dizini (index.json) okunamadı; çevrimiçi `enformik ai init` ile yeniden indirin.');
+            throw new CliError('Could not read the cached guide index (index.json); download it again with `enformik ai init` online.');
         }
         index = parseIndex(raw);
         if (cmpVersion(ctx.version, index.minCliVersion) < 0) {
-            throw new CliError(`Önbellekteki rehber en az CLI ${index.minCliVersion} ister (sizde ${ctx.version}). \`npm install -g @enformik/cli\` ile güncelleyin.`);
+            throw new CliError(`The cached guide requires CLI ${index.minCliVersion} or newer (you have ${ctx.version}). Update with \`npm install -g @enformik/cli\`.`);
         }
         source = 'cache';
-        out.warn(`Önbellekteki rehber kullanılıyor (sürüm ${index.guideVersion}); güncel olmayabilir.`);
+        out.warn(`Using the cached guide (version ${index.guideVersion}); it may be out of date.`);
         if (!existsSync(join(root, lang, 'overview.md')))
-            throw new CliError(`Önbellekte "${lang}" dilinde rehber yok.`);
+            throw new CliError(`No guide in language "${lang}" in the cache.`);
     }
     else {
         const base = joinUrl(ctx.settings.docsUrl, '/ai/');
-        assertSecureUrl(base, 'Doküman adresi');
+        assertSecureUrl(base, 'Docs URL');
         let res;
         try {
             res = await request(joinUrl(base, 'index.json'), { retries: 2, fetchImpl: ctx.fetchImpl, headers: { 'X-Enformik-CLI-Version': ctx.version } });
         }
         catch (e) {
-            throw new CliError(`${e.message}\nRehberler sunucudan çekilir; çevrimdışıysanız ve daha önce indirdiyseniz \`enformik ai init --offline\` kullanın.`);
+            throw new CliError(`${e.message}\nGuides are downloaded from the server; if you are offline and have downloaded them before, use \`enformik ai init --offline\`.`);
         }
+        if (res.status === 429)
+            throw rateLimitedError(res);
         if (!res.ok)
-            throw new CliError(`Rehber dizini alınamadı (HTTP ${res.status}): ${joinUrl(base, 'index.json')}`);
+            throw new CliError(`Could not fetch the guide index (HTTP ${res.status}): ${joinUrl(base, 'index.json')}`);
         index = parseIndex(res.json);
         if (cmpVersion(ctx.version, index.minCliVersion) < 0) {
-            throw new CliError(`Bu rehber en az CLI ${index.minCliVersion} ister (sizde ${ctx.version}). \`npm install -g @enformik/cli\` ile güncelleyin.`);
+            throw new CliError(`This guide requires CLI ${index.minCliVersion} or newer (you have ${ctx.version}). Update with \`npm install -g @enformik/cli\`.`);
         }
         if (!index.languages.includes(lang) || !index.files[lang])
-            throw new CliError(`Rehber "${lang}" dilinde yok (var olanlar: ${index.languages.join(', ')}).`);
+            throw new CliError(`The guide is not available in "${lang}" (available: ${index.languages.join(', ')}).`);
         // Önce hepsini indirip doğrula, sonra yaz: yarım rehber bırakma.
         const contents = new Map();
         for (const [name, sha] of Object.entries(index.files[lang]))
@@ -160,9 +164,9 @@ export async function aiInit(ctx) {
         written.push(u.f);
     }
     const fileCount = Object.keys(index.files[lang] ?? {}).length + Object.keys(index.shared).length;
-    out.info(`✓ Ajan rehberi hazır (sürüm ${index.guideVersion}, ${lang}, ${fileCount} dosya, kaynak: ${source === 'server' ? 'sunucu' : 'önbellek'}) → .enformik/ai/`);
-    out.info(written.length > 0 ? `  Talimat bloğu güncellendi: ${written.join(', ')}` : '  Talimat bloğu zaten güncel.');
-    out.info('  Sonraki adım: ajanın `.enformik/ai/' + lang + '/overview.md` dosyasını okuması.');
+    out.info(`✓ Agent guide ready (version ${index.guideVersion}, ${lang}, ${fileCount} files, source: ${source === 'server' ? 'server' : 'cache'}) → .enformik/ai/`);
+    out.info(written.length > 0 ? `  Instruction block updated: ${written.join(', ')}` : '  Instruction block already up to date.');
+    out.info('  Next step: have the agent read `.enformik/ai/' + lang + '/overview.md`.');
     out.result({ guideVersion: index.guideVersion, lang, source, files: fileCount, agentFiles: written, dir: '.enformik/ai' });
     return 0;
 }