Prepare v1.1.0 release

- Update version to 1.1.0 in package.json
- Add v1.1.0 changelog with fixes, additions, and changes
- Update @SInCE tags from TBD to 1.1.0
- Apply code formatting improvements

Author: mrcasual

CHANGELOG.md

@@ -1,7 +1,26 @@
 # Changelog
 
-## [1.0.0] - 2025-06-27
+## 1.1.0 — 2025-11-12
+
+### Fixed
+
+* Fix plural-form translations in languages with complex rules (e.g., Arabic, Russian,).
+* Treat environment variables such as `FORCE_TRANSLATE=false` correctly instead of interpreting them as `true`.
+* Ensure configuration files are detected when running Potomatic from paths containing spaces (such as `~/Local Sites/`) and on Windows systems.
 
 ### Added
 
-- 🚀 Initial release!
+* Support multiple API key formats (`OPENAI_API_KEY`, `POTOMATIC_OPENAI_API_KEY`, etc.) with automatic provider detection based on the key name.
+* Add CLI options `--prompt-file-path` and `--po-header-template-path` to customize the locations of translation prompt and header template files.
+
+### Changed
+
+* Update OpenAI pricing data to reflect current model costs (November 2025).
+
+## 1.0.1 — 2025-06-27
+
+* Version bump for [npm release](https://www.npmjs.com/package/potomatic).
+
+## 1.0.0 — 2025-06-27
+
+* Initial release.

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "potomatic",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"description": "AI-powered translation utility for translating .po(t) files into multiple languages",
 	"author": "GravityKit",
 	"keywords": [

src/config/index.js

@@ -144,7 +144,7 @@ function parseEnvironmentConfig() {
  * Creates a Zod schema for parsing boolean values from strings (env vars and CLI args).
  * Handles common string representations: "true", "false", "1", "0".
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @param {boolean} defaultValue - Default value if not provided or empty.
  *
@@ -163,7 +163,7 @@ function booleanStringSchema(defaultValue = false) {
  * Auto-detects provider from environment variable keys.
  * Checks for POTOMATIC_<PROVIDER>_API_KEY and <PROVIDER>_API_KEY patterns.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @return {string|null} Detected provider name (lowercase) or null if none detected.
  */

src/orchestrator/index.js

@@ -799,7 +799,7 @@ export class TranslationOrchestrator {
 	 *
 	 * @private
 	 *
-	 * @since TBD
+	 * @since 1.1.0
 	 *
 	 * @param {string} language - Language code.
 	 * @param {Object} stats - Language processing statistics.
@@ -814,9 +814,7 @@ export class TranslationOrchestrator {
 
 		if (totalValidationIssues > 0) {
 			const breakdown = formatValidationBreakdown(stats.validationStats);
-			this.mainLogger.warn(
-				`⚠️  ${language}: ${breakdown}. Run with -v 2 for details.`
-			);
+			this.mainLogger.warn(`⚠️  ${language}: ${breakdown}. Run with -v 2 for details.`);
 		}
 	}
 

src/providers/openai/OpenAIProvider.js

@@ -630,14 +630,7 @@ export class OpenAIProvider extends Provider {
 	_parseApiResponse(responseContent, batch, pluralCount, dictionaryCount = 0) {
 		try {
 			const verbosityLevel = this.config.verboseLevel || 1;
-			const { translations, validationStats } = parseXmlResponse(
-				responseContent,
-				batch,
-				pluralCount,
-				this.logger,
-				dictionaryCount,
-				verbosityLevel
-			);
+			const { translations, validationStats } = parseXmlResponse(responseContent, batch, pluralCount, this.logger, dictionaryCount, verbosityLevel);
 
 			return { translations, validationStats };
 		} catch (error) {

src/utils/reportingUtils.js

@@ -185,10 +185,7 @@ export function printTranslationRunSummary(allLanguageStats, logger, effectiveCh
 	}).length;
 
 	// Print overall results.
-	const summaryParts = [
-		`Languages processed: ${getStyledColor('success')(totals.languagesProcessed)}`,
-		`With errors: ${getStyledColor('error')(totals.languagesWithErrors)}`,
-	];
+	const summaryParts = [`Languages processed: ${getStyledColor('success')(totals.languagesProcessed)}`, `With errors: ${getStyledColor('error')(totals.languagesWithErrors)}`];
 
 	if (languagesWithWarnings > 0) {
 		summaryParts.push(`With warnings: ${getStyledColor('warning')(languagesWithWarnings)}`);

src/utils/validationStats.js

@@ -2,13 +2,13 @@
  * Validation statistics utilities.
  * Centralized validation type definitions and helper functions.
  *
- * @since TBD
+ * @since 1.1.0
  */
 
 /**
  * Registry of all validation types with their display names.
  *
- * @since TBD
+ * @since 1.1.0
  */
 export const VALIDATION_TYPES = {
 	stringsWithPluralIssues: 'strings with plural issues',
@@ -17,7 +17,7 @@ export const VALIDATION_TYPES = {
 /**
  * Creates an empty validation statistics object with all validation types initialized to 0.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @return {Object} Empty validation stats object.
  */
@@ -34,7 +34,7 @@ export function createEmptyValidationStats() {
 /**
  * Calculates the total number of validation issues.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @param {Object} validationStats - Validation statistics object.
  *
@@ -57,7 +57,7 @@ export function getTotalValidationIssues(validationStats) {
 /**
  * Formats validation stats as a human-readable breakdown string.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @param {Object} validationStats - Validation statistics object.
  *
@@ -83,7 +83,7 @@ export function formatValidationBreakdown(validationStats) {
 /**
  * Accumulates validation stats from a source object into a target object.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @param {Object} target - Target validation stats object to accumulate into.
  * @param {Object} source - Source validation stats object to accumulate from.

src/utils/xmlTranslation.js

@@ -102,7 +102,7 @@ export function buildDictionaryResponse(dictionaryMatches) {
  * Validates plural form translations.
  * Ensures correct form count and warns about incomplete translations.
  *
- * @since TBD
+ * @since 1.1.0
  *
  * @param {Array<string>} forms - Array of translated forms.
  * @param {string} originalMsgid - Original msgid for logging context.
@@ -119,7 +119,7 @@ function validatePluralForms(forms, originalMsgid, expectedCount, itemId, logger
 	const issues = [];
 
 	// Find first non-empty form to use as fallback.
-	const fallbackForm = correctedForms.find(f => f && f.trim() !== '') || '';
+	const fallbackForm = correctedForms.find((f) => f && f.trim() !== '') || '';
 
 	// Ensure we have exactly the right number of forms.
 	if (correctedForms.length < expectedCount) {
@@ -128,10 +128,7 @@ function validatePluralForms(forms, originalMsgid, expectedCount, itemId, logger
 		issues.push(`insufficient forms (expected ${expectedCount}, got ${correctedForms.length})`);
 
 		if (verbosityLevel >= 2) {
-			logger.warn(
-				`Insufficient plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` +
-				`Expected ${expectedCount}, got ${correctedForms.length}. Padding with first form as fallback.`
-			);
+			logger.warn(`Insufficient plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` + `Expected ${expectedCount}, got ${correctedForms.length}. Padding with first form as fallback.`);
 		}
 
 		while (correctedForms.length < expectedCount) {
@@ -143,36 +140,28 @@ function validatePluralForms(forms, originalMsgid, expectedCount, itemId, logger
 		issues.push(`excess forms (expected ${expectedCount}, got ${correctedForms.length})`);
 
 		if (verbosityLevel >= 2) {
-			logger.warn(
-				`Too many plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` +
-				`Expected ${expectedCount}, got ${correctedForms.length}. Truncating.`
-			);
+			logger.warn(`Too many plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` + `Expected ${expectedCount}, got ${correctedForms.length}. Truncating.`);
 		}
 
 		correctedForms = correctedForms.slice(0, expectedCount);
 	}
 
 	// Warn about empty forms (except when all are empty - likely not translated yet).
-	const nonEmptyCount = correctedForms.filter(f => f && f.trim() !== '').length;
+	const nonEmptyCount = correctedForms.filter((f) => f && f.trim() !== '').length;
 
 	if (nonEmptyCount > 0 && nonEmptyCount < expectedCount) {
 		hasIssues = true;
 
-		const emptyIndices = correctedForms
-			.map((f, i) => (f && f.trim() !== '' ? null : i))
-			.filter(i => i !== null);
+		const emptyIndices = correctedForms.map((f, i) => (f && f.trim() !== '' ? null : i)).filter((i) => i !== null);
 
 		issues.push(`incomplete forms (empty at indices [${emptyIndices.join(', ')}])`);
 
 		if (verbosityLevel >= 2) {
-			logger.warn(
-				`Incomplete plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` +
-				`Forms at indices [${emptyIndices.join(', ')}] are empty. Filling with first form as fallback.`
-			);
+			logger.warn(`Incomplete plural forms at index ${itemId} for "${originalMsgid.substring(0, 50)}...": ` + `Forms at indices [${emptyIndices.join(', ')}] are empty. Filling with first form as fallback.`);
 		}
 
 		// Fill empty forms with the first non-empty form as fallback.
-		correctedForms = correctedForms.map(f => (f && f.trim() !== '') ? f : fallbackForm);
+		correctedForms = correctedForms.map((f) => (f && f.trim() !== '' ? f : fallbackForm));
 	}
 
 	if (hasIssues && verbosityLevel >= 3) {
@@ -270,14 +259,7 @@ export function parseXmlResponse(xmlResponse, batch, pluralCount, logger, dictio
 				}
 
 				// Validate and auto-correct plural forms.
-				const { correctedForms, hasIssues } = validatePluralForms(
-					forms,
-					batch[batchIndex].msgid,
-					pluralCount,
-					responseIndex,
-					logger,
-					verbosityLevel
-				);
+				const { correctedForms, hasIssues } = validatePluralForms(forms, batch[batchIndex].msgid, pluralCount, responseIndex, logger, verbosityLevel);
 
 				if (hasIssues) {
 					validationStats.stringsWithPluralIssues++;
@@ -293,19 +275,9 @@ export function parseXmlResponse(xmlResponse, batch, pluralCount, logger, dictio
 					// If this entry expects plural forms, validate the result
 					if (batch[batchIndex].msgid_plural) {
 						if (verbosityLevel >= 2) {
-							logger.warn(
-								`Missing plural forms at index ${responseIndex} for "${batch[batchIndex].msgid.substring(0, 50)}...": ` +
-								`Expected ${pluralCount} forms but received singular translation. Using single translation for form 0 only.`
-							);
+							logger.warn(`Missing plural forms at index ${responseIndex} for "${batch[batchIndex].msgid.substring(0, 50)}...": ` + `Expected ${pluralCount} forms but received singular translation. Using single translation for form 0 only.`);
 						}
-						const { correctedForms, hasIssues } = validatePluralForms(
-							[translation],
-							batch[batchIndex].msgid,
-							pluralCount,
-							responseIndex,
-							logger,
-							verbosityLevel
-						);
+						const { correctedForms, hasIssues } = validatePluralForms([translation], batch[batchIndex].msgid, pluralCount, responseIndex, logger, verbosityLevel);
 
 						if (hasIssues) {
 							validationStats.stringsWithPluralIssues++;