msgai-cli 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [1.2.0](https://github.com/AlexMost/msgai/compare/v1.1.1...v1.2.0) (2026-03-02)
+
+### Features
+
+- add configurable po fold length ([343775c](https://github.com/AlexMost/msgai/commit/343775c8046abf6705ca02d687305d1db1e2c9c6))
+
 ## [1.1.1](https://github.com/AlexMost/msgai/compare/v1.1.0...v1.1.1) (2026-03-01)
 
 ### Bug Fixes

package/README.md

@@ -79,7 +79,7 @@ msgai messages.po --api-key sk-...
 Usage:
 
 ```bash
-msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--debug]
+msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--fold-length N] [--debug]
 ```
 
 Options:
@@ -89,6 +89,7 @@ Options:
 - `--source-lang LANG`: set the source language of `msgid` strings as an ISO 639-1 code such as `en` or `uk`
 - `--model MODEL`: set the OpenAI model used for translation; default is `gpt-4o`. Only models with `json_schema` structured outputs are supported.
 - `--api-key KEY`: pass the OpenAI API key directly instead of using `OPENAI_API_KEY`
+- `--fold-length N`: set PO line fold length when writing files. Use `0` to disable folding and minimize formatting-only diffs. Default: `0`
 - `--debug`: print debug logs for batch preparation, OpenAI request retries, request payloads, and raw response validation
 - `--help`: print command usage
 

package/dist/src/cli/index.js

@@ -8,11 +8,23 @@ const yargs_1 = __importDefault(require("yargs/yargs"));
 const helpers_1 = require("yargs/helpers");
 const debug_1 = require("../debug");
 const runTranslate_1 = require("./runTranslate");
+function normalizeFoldLength(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error('Invalid --fold-length. Expected a non-negative integer.');
+    }
+    if (value < 0) {
+        throw new Error('Invalid --fold-length. Expected a non-negative integer.');
+    }
+    return value;
+}
 function parseArgs(argv) {
     try {
         const parsedArgs = (0, yargs_1.default)(argv)
             .scriptName('msgai')
-            .usage('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--debug]')
+            .usage('Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--fold-length N] [--debug]')
             .option('dry-run', {
             type: 'boolean',
             default: false,
@@ -33,6 +45,10 @@ function parseArgs(argv) {
             .option('model', {
             type: 'string',
             description: 'OpenAI model to use for translation. Default: gpt-4o',
+        })
+            .option('fold-length', {
+            type: 'number',
+            description: 'PO line fold length when writing files. Use 0 to disable folding. Default: 0',
         })
             .option('help', {
             alias: 'h',
@@ -61,6 +77,7 @@ function parseArgs(argv) {
             : undefined;
         const modelRaw = parsedArgs.model;
         const model = modelRaw != null && String(modelRaw).trim() !== '' ? String(modelRaw).trim() : undefined;
+        const foldLength = normalizeFoldLength(parsedArgs['fold-length']);
         if (positionalArgs.length > 1) {
             const result = {
                 dryRun: Boolean(parsedArgs['dry-run']),
@@ -69,6 +86,7 @@ function parseArgs(argv) {
                 sourceLang,
                 model,
                 includeFuzzy: Boolean(parsedArgs['include-fuzzy']),
+                foldLength,
                 debug: Boolean(parsedArgs.debug),
                 error: `Unexpected argument: ${positionalArgs[1]}`,
             };
@@ -82,6 +100,7 @@ function parseArgs(argv) {
             sourceLang,
             model,
             includeFuzzy: Boolean(parsedArgs['include-fuzzy']),
+            foldLength,
             debug: Boolean(parsedArgs.debug),
         };
         return result;
@@ -91,7 +110,7 @@ function parseArgs(argv) {
         return { dryRun: false, help: false, error: message };
     }
 }
-const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--debug]';
+const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--fold-length N] [--debug]';
 function main(argv) {
     const args = parseArgs(argv);
     (0, debug_1.initDebugLogger)(args.debug);
@@ -116,6 +135,7 @@ function main(argv) {
         sourceLang: args.sourceLang,
         model: args.model,
         includeFuzzy: args.includeFuzzy,
+        foldLength: args.foldLength,
         debug: args.debug,
     });
     if (result instanceof Promise) {

package/dist/src/cli/runTranslate.js

@@ -48,7 +48,7 @@ function getInvalidModelMessage(model) {
         `Supported model families: ${translate_1.SUPPORTED_STRUCTURED_OUTPUT_MODELS.join(', ')}.`,
     ].join(' ');
 }
-async function runTranslate(poFilePath, apiKey, sourceLang, model, includeFuzzy, debug) {
+async function runTranslate(poFilePath, apiKey, sourceLang, model, includeFuzzy, foldLength, debug) {
     (0, debug_1.initDebugLogger)(debug);
     const debugLogger = (0, debug_1.getDebugLogger)();
     try {
@@ -117,7 +117,7 @@ async function runTranslate(poFilePath, apiKey, sourceLang, model, includeFuzzy,
             if (includeFuzzy) {
                 (0, po_1.clearFuzzyFromEntries)(parsedPo, batchResults);
             }
-            node_fs_1.default.writeFileSync(poFilePath, (0, po_1.compilePo)(parsedPo));
+            node_fs_1.default.writeFileSync(poFilePath, (0, po_1.compilePo)(parsedPo, { foldLength }));
             debugLogger.log('cli.runTranslate', 'Wrote translated batch back to PO file', {
                 batch: batchNum,
                 poFilePath,
@@ -139,7 +139,7 @@ async function runTranslate(poFilePath, apiKey, sourceLang, model, includeFuzzy,
         return 1;
     }
 }
-const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--debug]';
+const USAGE = 'Usage: msgai <file.po> [--dry-run] [--api-key KEY] [--source-lang LANG] [--model MODEL] [--include-fuzzy] [--fold-length N] [--debug]';
 function runTranslateCommand(args) {
     (0, debug_1.initDebugLogger)(args.debug);
     const debugLogger = (0, debug_1.getDebugLogger)();
@@ -190,7 +190,7 @@ function runTranslateCommand(args) {
             console.warn(message.replace('pass apiKey in options', 'pass --api-key'));
             return 1;
         }
-        return runTranslate(args.poFilePath, resultApiKey, args.sourceLang, args.model, args.includeFuzzy, args.debug);
+        return runTranslate(args.poFilePath, resultApiKey, args.sourceLang, args.model, args.includeFuzzy, args.foldLength, args.debug);
     }
     try {
         const poContent = node_fs_1.default.readFileSync(args.poFilePath, 'utf8');

package/dist/src/po.js

@@ -10,6 +10,7 @@ exports.applyTranslations = applyTranslations;
 exports.clearFuzzyFromEntries = clearFuzzyFromEntries;
 exports.compilePo = compilePo;
 const gettext_parser_1 = require("gettext-parser");
+const DEFAULT_FOLD_LENGTH = 0;
 function getUntranslatedMsgids(parsedPo) {
     const untranslatedMsgids = [];
     const translations = parsedPo.translations;
@@ -154,6 +155,9 @@ function clearFuzzyFromEntries(parsedPo, results) {
 /**
  * Compiles the parsed PO to a buffer (no file I/O).
  */
-function compilePo(parsedPo) {
-    return gettext_parser_1.po.compile(parsedPo);
+function compilePo(parsedPo, options) {
+    return gettext_parser_1.po.compile(parsedPo, {
+        foldLength: options?.foldLength ?? DEFAULT_FOLD_LENGTH,
+        sort: false,
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "msgai-cli",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "CLI that automatically translates all untranslated strings in gettext (.po) files using AI (LLM)",
   "main": "dist/src/cli/index.js",
   "bin": {