langctl 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,517 +1,286 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
+import { Command, CommanderError, Option } from 'commander';
 import chalk from 'chalk';
-import { initCommand } from './commands/init.js';
-import { authCommand, logoutCommand } from './commands/auth.js';
-import { configCommand } from './commands/config.js';
-import { projectsListCommand, projectsCreateCommand, projectsGetCommand, projectsUpdateCommand, projectsDeleteCommand, projectsAddLanguageCommand, projectsRemoveLanguageCommand, projectsStatsCommand } from './commands/projects.js';
-import { listKeysCommand, getKeyCommand, createKeyCommand, deleteKeyCommand, translateKeyCommand, publishKeysCommand } from './commands/keys.js';
-import { listTeamCommand, getTeamMemberCommand, inviteTeamMemberCommand, removeTeamMemberCommand, updateTeamRoleCommand, listInvitationsCommand, revokeInvitationCommand } from './commands/team.js';
-import { orgInfoCommand, orgStatsCommand, orgPlanCommand } from './commands/org.js';
-import { pullCommand } from './commands/pull.js';
+import { authCommand, logoutCommand, whoamiCommand } from './commands/auth.js';
+import { configCommand, formatsCommand } from './commands/config.js';
 import { exportCommand } from './commands/export.js';
 import { importCommand } from './commands/import.js';
-import { debugListApiKeys, debugListOrganizations } from './commands/debug.js';
-import { showLogo } from './utils/banner.js';
+import { initCommand } from './commands/init.js';
+import { createKeyCommand, deleteKeyCommand, getKeyCommand, listKeysCommand, publishKeysCommand, updateKeyCommand } from './commands/keys.js';
+import { orgInfoCommand, orgPlanCommand, orgStatsCommand } from './commands/org.js';
+import { projectsAddLanguageCommand, projectsCreateCommand, projectsDeleteCommand, projectsGetCommand, projectsListCommand, projectsRemoveLanguageCommand, projectsStatsCommand, projectsUpdateCommand, } from './commands/projects.js';
+import { pullCommand } from './commands/pull.js';
+import { pushCommand } from './commands/push.js';
+import { translateCommand } from './commands/translate.js';
+import { reviewCommand } from './commands/review.js';
+import { getTeamMemberCommand, inviteTeamMemberCommand, listInvitationsCommand, listTeamCommand, removeTeamMemberCommand, revokeInvitationCommand, updateTeamRoleCommand, } from './commands/team.js';
+import { flagOverrides } from './core/config.js';
+import { CliError, ExitCode, usageError } from './core/errors.js';
+import { httpSettings } from './core/http.js';
+import { log, printJson, runtime } from './core/output.js';
+import { VERSION } from './version.js';
+const collect = (value, previous = []) => [...previous, value];
+/** Global flags, accepted before or after the subcommand (`langctl --json pull` and `langctl pull --json`). */
+function withGlobals(cmd) {
+    return cmd
+        .option('--json', 'machine-readable JSON output on stdout')
+        .option('-q, --quiet', 'only print results and errors')
+        .option('--verbose', 'log HTTP requests to stderr')
+        .option('-y, --yes', 'skip confirmation prompts (required for destructive commands in CI)')
+        .option('--api-key <key>', 'API key (prefer the LANGCTL_API_KEY env var)')
+        .option('--api-url <url>', 'API base URL (env: LANGCTL_API_URL)')
+        .option('--timeout <seconds>', 'request timeout in seconds (env: LANGCTL_TIMEOUT)')
+        .option('--no-color', 'disable colors (also honors NO_COLOR)');
+}
+/** Wrap an action so every command shares the same error handling and exit codes. */
+function run(fn) {
+    return async (...args) => {
+        await fn(...args);
+    };
+}
 const program = new Command();
-// Package info
-const packageJson = {
-    name: 'langctl',
-    version: '0.2.0',
-    description: 'CLI-first translation management for developers'
-};
 program
     .name('langctl')
-    .description(packageJson.description)
-    .version(packageJson.version, '-v, --version', 'Show version number');
-// Init command
-program
-    .command('init')
-    .description('Interactive setup wizard')
-    .action(async () => {
-    try {
-        await initCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Auth command
-program
-    .command('auth <api-key>')
-    .description('Authenticate and save credentials')
-    .action(async (apiKey) => {
-    try {
-        await authCommand(apiKey);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Logout command
-program
-    .command('logout')
-    .description('Clear authentication credentials')
-    .action(async () => {
-    try {
-        await logoutCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Config command
-program
-    .command('config')
-    .description('View current configuration')
-    .action(() => {
-    try {
-        configCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Projects command
-const projects = program
-    .command('projects')
-    .description('Manage projects');
-projects
-    .command('list')
-    .description('Show all accessible projects')
-    .action(async () => {
-    try {
-        await projectsListCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('create <name>')
-    .description('Create a new project')
-    .option('-d, --description <text>', 'Project description')
-    .option('-l, --languages <langs>', 'Comma-separated language codes (e.g., en,es,fr)', 'en')
-    .option('--default-language <code>', 'Default language code')
-    .action(async (name, options) => {
-    try {
-        await projectsCreateCommand(name, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('get <slug>')
-    .description('Get project details')
-    .action(async (slug) => {
-    try {
-        await projectsGetCommand(slug);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('update <slug>')
-    .description('Update project')
-    .option('-n, --name <name>', 'New project name')
-    .option('-d, --description <text>', 'New description')
-    .option('-l, --languages <langs>', 'Comma-separated language codes')
-    .option('--default-language <code>', 'Default language code')
-    .action(async (slug, options) => {
-    try {
-        await projectsUpdateCommand(slug, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('delete <slug>')
-    .description('Delete project')
-    .action(async (slug) => {
-    try {
-        await projectsDeleteCommand(slug);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('add-language <slug> <language>')
-    .description('Add language to project')
-    .action(async (slug, language) => {
-    try {
-        await projectsAddLanguageCommand(slug, language);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('remove-language <slug> <language>')
-    .description('Remove language from project')
-    .action(async (slug, language) => {
-    try {
-        await projectsRemoveLanguageCommand(slug, language);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-projects
-    .command('stats <slug>')
-    .description('Get project statistics')
-    .action(async (slug) => {
-    try {
-        await projectsStatsCommand(slug);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Keys command
-const keys = program
-    .command('keys')
-    .description('Manage translation keys');
-keys
-    .command('list <project>')
-    .description('List translation keys')
-    .option('-m, --module <name>', 'Filter by module')
-    .option('-p, --published', 'Show only published keys')
-    .option('-s, --search <term>', 'Search keys')
-    .option('--limit <number>', 'Limit results', '100')
-    .option('--offset <number>', 'Offset results', '0')
-    .action(async (project, options) => {
-    try {
-        await listKeysCommand(project, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-keys
-    .command('get <project> <key>')
-    .description('Get key details')
-    .action(async (project, key) => {
-    try {
-        await getKeyCommand(project, key);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-keys
-    .command('create <project> <key>')
-    .description('Create translation key')
-    .option('-d, --description <text>', 'Key description')
-    .option('-m, --module <name>', 'Module name')
-    .option('--value-en <value>', 'English value')
-    .option('--value-es <value>', 'Spanish value')
-    .option('--value-fr <value>', 'French value')
-    .option('--value-de <value>', 'German value')
-    .option('--tags <tags>', 'Comma-separated tags')
-    .action(async (project, key, options) => {
-    try {
-        await createKeyCommand(project, key, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-keys
-    .command('delete <project> <key>')
-    .description('Delete translation key')
-    .action(async (project, key) => {
-    try {
-        await deleteKeyCommand(project, key);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-keys
-    .command('translate <project> <key>')
-    .description('Update translation for a key')
-    .requiredOption('-l, --language <code>', 'Language code')
-    .requiredOption('-v, --value <text>', 'Translation value')
-    .action(async (project, key, options) => {
-    try {
-        await translateKeyCommand(project, key, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-keys
-    .command('publish <project> <keys...>')
-    .description('Publish translation keys')
-    .option('--unpublish', 'Unpublish instead of publish')
-    .action(async (project, keysList, options) => {
-    try {
-        await publishKeysCommand(project, keysList, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Team command
-const team = program
-    .command('team')
-    .description('Manage team members');
-team
-    .command('list')
-    .description('List team members')
-    .action(async () => {
-    try {
-        await listTeamCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-team
-    .command('get <email>')
-    .description('Get team member details')
-    .action(async (email) => {
-    try {
-        await getTeamMemberCommand(email);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-team
-    .command('invite <email>')
-    .description('Invite team member')
-    .option('-r, --role <role>', 'Member role: viewer, member, admin', 'member')
-    .action(async (email, options) => {
-    try {
-        await inviteTeamMemberCommand(email, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
+    .description('Translation management for developers — sync i18n files between your code, CI and Langctl.')
+    .version(VERSION, '-v, --version', 'print the version')
+    .showHelpAfterError('(run with --help for usage)')
+    .configureHelp({ sortSubcommands: false })
+    .exitOverride();
+withGlobals(program);
+program.hook('preAction', (_root, action) => {
+    const o = action.optsWithGlobals();
+    runtime.json = Boolean(o.json);
+    runtime.quiet = Boolean(o.quiet);
+    runtime.verbose = Boolean(o.verbose);
+    runtime.yes = Boolean(o.yes);
+    if (o.color === false || process.env.NO_COLOR)
+        chalk.level = 0;
+    if (typeof o.apiKey === 'string')
+        flagOverrides.apiKey = o.apiKey;
+    if (typeof o.apiUrl === 'string')
+        flagOverrides.apiUrl = o.apiUrl;
+    if (o.timeout !== undefined) {
+        const s = Number(o.timeout);
+        if (!Number.isFinite(s) || s <= 0)
+            throw usageError('--timeout must be a positive number of seconds');
+        httpSettings.timeoutMs = s * 1000;
+    }
+});
+// ── Setup & auth ────────────────────────────────────────────────
+withGlobals(program.command('init'))
+    .description('set up this repository: authenticate if needed and write langctl.json')
+    .option('-p, --project <slug>', 'project slug')
+    .option('-f, --format <format>', 'file format (see "langctl formats")')
+    .option('-o, --output <template>', 'path template for files, e.g. src/locales/{lang}.json')
+    .option('--force', 'overwrite an existing langctl.json')
+    .action(run(opts => initCommand(opts)));
+withGlobals(program.command('auth [api-key]'))
+    .description('store an API key (prefer --stdin so the key stays out of shell history)')
+    .option('--stdin', 'read the API key from stdin')
+    .action(run((key, opts) => authCommand(key, opts)));
+withGlobals(program.command('logout')).description('remove the stored API key').action(run(() => logoutCommand()));
+withGlobals(program.command('whoami')).alias('status').description('show the organization, key and scopes in use, and check connectivity')
+    .action(run(() => whoamiCommand()));
+withGlobals(program.command('config')).description('show effective configuration and where it comes from').action(run(() => configCommand()));
+withGlobals(program.command('formats')).description('list supported file formats').action(run(() => formatsCommand()));
+// ── Sync ────────────────────────────────────────────────────────
+withGlobals(program.command('pull [project]'))
+    .description('download translations into files (project/format/output default to langctl.json)')
+    .option('-l, --languages <codes>', 'comma-separated languages (default: all)')
+    .addOption(new Option('--language <code>').hideHelp())
+    .option('-f, --format <format>', 'file format (default: json)')
+    .option('-o, --output <template>', 'path template, e.g. "src/locales/{lang}.json"')
+    .addOption(new Option('-d, --dir <path>', 'legacy: base directory for the default layout').hideHelp())
+    .option('-m, --module <name>', 'only keys from this module')
+    .option('--include-drafts', 'include unpublished keys (excluded by default)')
+    .option('--include-unreviewed', 'include AI translations nobody has reviewed yet (excluded by default)')
+    .addOption(new Option('--no-published-only').hideHelp())
+    .option('--check', 'do not write; exit 7 if any file is out of date (for CI)')
+    .option('--dry-run', 'show what would change without writing')
+    .option('--require-complete', 'exit 1 if any language is missing translations')
+    .action(run((project, opts) => pullCommand(project, { ...opts, languages: opts.languages ?? opts.language })));
+withGlobals(program.command('push [project]'))
+    .description('upload translation files (by default only the source language)')
+    .option('-l, --languages <codes>', 'comma-separated languages, or "all" (default: source language)')
+    .option('-f, --format <format>', 'file format (default: from langctl.json or file extension)')
+    .option('-i, --input <template>', 'path template to read, e.g. "src/locales/{lang}.json"')
+    .option('-m, --module <name>', 'assign new keys to this module')
+    .option('--overwrite', 'replace existing translations (default: only add new keys/languages)')
+    .option('--publish', 'publish the uploaded keys')
+    .option('--dry-run', 'show what would change without uploading')
+    .action(run((project, opts) => pushCommand(project, opts)));
+withGlobals(program.command('export [project]'))
+    .description('export translations to a file (one-off; "pull" is the repo workflow)')
+    .option('-l, --language <code>', 'language to export (default: all)')
+    .option('--languages <codes>', 'comma-separated languages')
+    .option('-f, --format <format>', 'file format (default: json)')
+    .option('-o, --output <path>', 'output file, or template with {lang}')
+    .option('-m, --module <name>', 'only keys from this module')
+    .option('--include-drafts', 'include unpublished keys')
+    .addOption(new Option('--include-unpublished').hideHelp())
+    .action(run((project, opts) => exportCommand(project, opts)));
+withGlobals(program.command('import <project-or-file> [file]'))
+    .description('import one translation file (project may come from langctl.json)')
+    .option('-l, --language <code>', 'language of the file (default: project default language)')
+    .option('-f, --format <format>', 'file format (default: from extension)')
+    .option('-m, --module <name>', 'assign new keys to this module')
+    .option('--overwrite', 'replace existing translations')
+    .option('--publish', 'publish the imported keys')
+    .option('--dry-run', 'show what would change without uploading')
+    .action(run((a, b, opts) => importCommand(a, b, opts)));
+// ── Projects ────────────────────────────────────────────────────
+const projects = program.command('projects').alias('project').description('manage projects');
+withGlobals(projects.command('list')).alias('ls').description('list projects').action(run(() => projectsListCommand()));
+withGlobals(projects.command('get <slug>')).description('show a project').action(run((slug) => projectsGetCommand(slug)));
+withGlobals(projects.command('create <name>')).description('create a project')
+    .option('-d, --description <text>', 'description')
+    .option('-l, --languages <codes>', 'comma-separated languages', 'en')
+    .option('--default-language <code>', 'default (source) language — defaults to the first of --languages')
+    .action(run((name, opts) => projectsCreateCommand(name, opts)));
+withGlobals(projects.command('update <slug>')).description('update a project')
+    .option('-n, --name <name>', 'new name (the slug never changes)')
+    .option('-d, --description <text>', 'new description')
+    .option('-l, --languages <codes>', 'set the full language list (removing a language deletes its translations)')
+    .option('--default-language <code>', 'default language')
+    .action(run((slug, opts) => projectsUpdateCommand(slug, opts)));
+withGlobals(projects.command('delete <slug>')).description('delete a project and its keys (asks to confirm; --yes in CI)')
+    .action(run((slug) => projectsDeleteCommand(slug)));
+withGlobals(projects.command('add-language <slug> <codes...>')).description('add languages to a project')
+    .action(run((slug, codes) => projectsAddLanguageCommand(slug, codes)));
+withGlobals(projects.command('remove-language <slug> <codes...>')).description('remove languages and their translations')
+    .action(run((slug, codes) => projectsRemoveLanguageCommand(slug, codes)));
+withGlobals(projects.command('stats <slug>')).description('key counts and translation coverage per language')
+    .action(run((slug) => projectsStatsCommand(slug)));
+// ── Keys ────────────────────────────────────────────────────────
+const keys = program.command('keys').alias('key').description('manage translation keys');
+withGlobals(keys.command('list [project]')).alias('ls').description('list keys')
+    .option('-m, --module <name>', 'filter by module')
+    .option('-p, --published', 'only published keys')
+    .option('--drafts', 'only unpublished keys')
+    .option('-s, --search <text>', 'search key names and descriptions')
+    .option('--limit <n>', 'show at most n keys')
+    .addOption(new Option('--offset <n>').hideHelp())
+    .action(run((project, opts) => listKeysCommand(project, opts)));
+withGlobals(keys.command('get <project> <key>')).description('show a key and all its translations')
+    .action(run((project, key) => getKeyCommand(project, key)));
+withGlobals(keys.command('create <project> <key>')).description('create a key')
+    .option('--value <lang=text>', 'translation, repeatable: --value en="Hi" --value es="Hola"', collect)
+    .option('-d, --description <text>', 'context for translators')
+    .option('-m, --module <name>', 'module')
+    .option('--tags <tags>', 'comma-separated tags')
+    .option('--publish', 'publish immediately (default: draft)')
+    .addOption(new Option('--value-en <text>').hideHelp())
+    .addOption(new Option('--value-es <text>').hideHelp())
+    .addOption(new Option('--value-fr <text>').hideHelp())
+    .addOption(new Option('--value-de <text>').hideHelp())
+    .action(run((project, key, opts) => createKeyCommand(project, key, opts)));
+withGlobals(keys.command('update <project> <key>')).description('update translations, description or module')
+    .option('--value <lang=text>', 'translation, repeatable', collect)
+    .option('-d, --description <text>', 'description')
+    .option('-m, --module <name>', 'module')
+    .action(run((project, key, opts) => updateKeyCommand(project, key, opts)));
+withGlobals(keys.command('translate <project> <key>')).description('set one translation (same as update --value)')
+    .requiredOption('-l, --language <code>', 'language')
+    .requiredOption('-t, --text <text>', 'translation text')
+    .addOption(new Option('--value <text>').hideHelp())
+    .action(run((project, key, opts) => updateKeyCommand(project, key, { language: opts.language, text: opts.text ?? opts.value })));
+withGlobals(keys.command('delete <project> <keys...>')).alias('rm').description('delete keys (asks to confirm; --yes in CI)')
+    .action(run((project, names) => deleteKeyCommand(project, names)));
+withGlobals(keys.command('publish <project> [keys...]')).description('publish keys so pull/export include them')
+    .option('--all', 'publish every draft key')
+    .option('-m, --module <name>', 'publish every draft key in a module')
+    .addOption(new Option('--unpublish').hideHelp())
+    .action(run((project, names, opts) => publishKeysCommand(project, names, opts, true)));
+withGlobals(keys.command('unpublish <project> [keys...]')).description('move keys back to draft')
+    .option('--all', 'unpublish every published key')
+    .option('-m, --module <name>', 'unpublish every key in a module')
+    .action(run((project, names, opts) => publishKeysCommand(project, names, opts, false)));
+// ── AI translation ──────────────────────────────────────────────
+withGlobals(program.command('translate [project]')).description('fill missing translations with AI (DeepL) from the default language')
+    .option('-t, --to <codes>', 'comma-separated target languages (default: every non-default language)')
+    .option('-k, --keys <names>', 'only these keys (comma-separated)')
+    .option('-m, --module <name>', 'only keys in a module')
+    .option('--overwrite', 'retranslate keys that already have a translation')
+    .option('--dry-run', 'show what would be translated without using any AI translations')
+    .action(run((project, opts) => translateCommand(project, opts)));
+withGlobals(program.command('review [project]')).description('list AI translations awaiting review, or approve them')
+    .option('--approve', 'approve the listed translations (asks to confirm; --yes in CI)')
+    .option('-k, --keys <names>', 'only these keys (comma-separated)')
+    .option('-l, --languages <codes>', 'only these languages (comma-separated)')
+    .action(run((project, opts) => reviewCommand(project, opts)));
+// ── Team & org ──────────────────────────────────────────────────
+const team = program.command('team').description('manage team members (needs an API key with the org:admin scope)');
+withGlobals(team.command('list')).alias('ls').description('list members').action(run(() => listTeamCommand()));
+withGlobals(team.command('get <email>')).description('show a member').action(run((email) => getTeamMemberCommand(email)));
+withGlobals(team.command('invite <email>')).description('invite someone')
+    .option('-r, --role <role>', 'viewer, member or admin', 'member')
+    .action(run((email, opts) => inviteTeamMemberCommand(email, opts)));
+withGlobals(team.command('remove <email>')).description('remove a member (asks to confirm; --yes in CI)')
+    .action(run((email) => removeTeamMemberCommand(email)));
+withGlobals(team.command('update-role <email> <role>')).description('change a member\'s role')
+    .action(run((email, role) => updateTeamRoleCommand(email, role)));
+withGlobals(team.command('invitations')).description('list invitations')
+    .option('-p, --pending', 'only pending invitations')
+    .option('--status <status>', 'pending, accepted, expired or revoked')
+    .action(run(opts => listInvitationsCommand(opts)));
+withGlobals(team.command('revoke-invitation <email>')).description('revoke a pending invitation')
+    .action(run((email) => revokeInvitationCommand(email)));
+const org = program.command('org').description('organization info');
+withGlobals(org.command('info')).description('organization details').action(run(() => orgInfoCommand()));
+withGlobals(org.command('stats')).description('member, project and key counts').action(run(() => orgStatsCommand()));
+withGlobals(org.command('plan')).description('plan limits and usage').action(run(() => orgPlanCommand()));
+program.addHelpText('after', `
+Getting started:
+  $ langctl init                      # authenticate and create langctl.json
+  $ langctl pull                      # download translations
+  $ langctl push                      # upload new source strings
+
+In CI (no config file needed):
+  env LANGCTL_API_KEY=lc_…  (store it as a secret)
+  $ langctl pull --check              # fail if committed files are out of date
+  $ langctl push --dry-run --json     # preview what would be uploaded
+
+Exit codes:
+  0 ok · 1 error · 2 invalid usage · 3 auth/permission · 4 not found
+  5 network/API unavailable · 6 plan limit reached · 7 files out of date (--check)
+
+Docs: https://langctl.com/docs`);
+// ── Run ─────────────────────────────────────────────────────────
+process.on('SIGINT', () => {
+    process.stderr.write('\n');
+    process.exit(130);
+});
+async function main() {
+    if (process.argv.length <= 2) {
+        program.outputHelp();
+        return;
+    }
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        process.exitCode = handleError(err);
     }
-});
-team
-    .command('remove <email>')
-    .description('Remove team member')
-    .action(async (email) => {
-    try {
-        await removeTeamMemberCommand(email);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-team
-    .command('update-role <email> <role>')
-    .description('Update member role (viewer, member, admin)')
-    .action(async (email, role) => {
-    try {
-        await updateTeamRoleCommand(email, role);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-team
-    .command('invitations')
-    .description('List invitations')
-    .option('-p, --pending', 'Show only pending invitations')
-    .action(async (options) => {
-    try {
-        await listInvitationsCommand(options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-team
-    .command('revoke-invitation <email>')
-    .description('Revoke pending invitation')
-    .action(async (email) => {
-    try {
-        await revokeInvitationCommand(email);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Organization command
-const org = program
-    .command('org')
-    .description('Manage organization');
-org
-    .command('info')
-    .description('Get organization information')
-    .action(async () => {
-    try {
-        await orgInfoCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-org
-    .command('stats')
-    .description('Get organization statistics')
-    .action(async () => {
-    try {
-        await orgStatsCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-org
-    .command('plan')
-    .description('Get subscription plan and limits')
-    .action(async () => {
-    try {
-        await orgPlanCommand();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Pull command (deprecated, use export)
-program
-    .command('pull <project>')
-    .description('Pull translations from a project (deprecated, use export)')
-    .option('-l, --language <code>', 'Pull specific language only (default: all)')
-    .option('-f, --format <type>', 'Export format: json, json-nested, ios, android, flutter (default: json)')
-    .option('-d, --dir <path>', 'Output directory (default: ./translations)')
-    .option('-o, --output <path>', 'Specific output file path (optional)')
-    .option('--no-published-only', 'Include unpublished translations')
-    .action(async (project, options) => {
-    try {
-        await pullCommand(project, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Export command
-program
-    .command('export <project>')
-    .description('Export translations from a project')
-    .option('-l, --language <code>', 'Export specific language (default: all)')
-    .option('-f, --format <type>', 'Export format: flat-json, nested-json, i18n-json, android-xml, ios-strings, flutter-arb (default: flat-json)')
-    .option('-o, --output <path>', 'Output file path')
-    .option('-m, --module <name>', 'Export only keys from specific module')
-    .option('--include-unpublished', 'Include unpublished translations')
-    .action(async (project, options) => {
-    try {
-        await exportCommand(project, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Import command
-program
-    .command('import <project> <file>')
-    .description('Import translations from a file')
-    .requiredOption('-l, --language <code>', 'Target language code')
-    .option('--overwrite', 'Overwrite existing translations')
-    .option('--publish', 'Auto-publish after import')
-    .action(async (project, file, options) => {
-    try {
-        await importCommand(project, file, options);
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Debug command
-const debug = program
-    .command('debug')
-    .description('Debug helpers');
-debug
-    .command('list-api-keys')
-    .description('Test API connection and show debug info')
-    .action(async () => {
-    try {
-        await debugListApiKeys();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-debug
-    .command('list-organizations')
-    .description('Show current organization details')
-    .action(async () => {
-    try {
-        await debugListOrganizations();
-    }
-    catch (error) {
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exit(1);
-    }
-});
-// Help command
-program.on('--help', () => {
-    console.log('');
-    console.log('Examples:');
-    console.log('  $ langctl init');
-    console.log('  $ langctl auth lc_abc123...');
-    console.log('  $ langctl projects list');
-    console.log('');
-    console.log('  # Pull all languages as JSON to ./translations/i18n/');
-    console.log('  $ langctl pull litcode');
-    console.log('');
-    console.log('  # Pull to custom directory (e.g., ./src/i18n/)');
-    console.log('  $ langctl pull litcode --dir ./src/i18n');
-    console.log('');
-    console.log('  # Pull specific language');
-    console.log('  $ langctl pull litcode --language en');
-    console.log('');
-    console.log('  # Pull all languages in iOS format to ./ios/localization/');
-    console.log('  $ langctl pull litcode --format ios --dir ./ios/localization');
-    console.log('');
-    console.log('For more information, visit: https://langctl.com/docs');
-    console.log('');
-});
-// Parse arguments
-program.parse(process.argv);
-// Show help if no command provided
-if (!process.argv.slice(2).length) {
-    showLogo();
-    program.outputHelp();
 }
-//# sourceMappingURL=index.js.map
+function handleError(err) {
+    if (err instanceof CommanderError) {
+        // help/version requests exit cleanly; everything else commander rejects is a usage error
+        if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version' || err.code === 'commander.help')
+            return 0;
+        return ExitCode.Usage;
+    }
+    if (err instanceof CliError) {
+        if (runtime.json)
+            printJson({ error: { message: err.message, exitCode: err.exitCode, hint: err.hint ?? null, status: err.status ?? null } });
+        log.error(err.message, err.hint);
+        return err.exitCode;
+    }
+    const e = err;
+    if (runtime.json)
+        printJson({ error: { message: e?.message ?? String(err), exitCode: ExitCode.Error } });
+    log.error(e?.message ?? String(err), 'This looks like a bug — please report it at https://github.com/litcode-pvt-ltd/langctl-cli/issues (run with --verbose for details).');
+    if (runtime.verbose && e?.stack)
+        process.stderr.write(e.stack + '\n');
+    return ExitCode.Error;
+}
+void main();