@intlayer/cli 9.1.3 → 9.2.0

package/dist/esm/reviewDoc/reviewDoc.mjs

@@ -3,7 +3,9 @@ import { getOutputFilePath } from "../utils/getOutputFilePath.mjs";
 import { checkFileModifiedRange } from "../utils/checkFileModifiedRange.mjs";
 import { formatLineRanges } from "../utils/formatLineRanges.mjs";
 import { reviewFileBlockAware } from "./reviewDocBlockAware.mjs";
-import { logReviewFileBlocks } from "./reviewDocLog.mjs";
+import { buildFileReviewReport, logReviewFileBlocks } from "./reviewDocLog.mjs";
+import { createReviewProgressLogger } from "./reviewDocProgress.mjs";
+import { formatReviewSynthesis } from "./reviewDocSynthesis.mjs";
 import { existsSync } from "node:fs";
 import { join, relative } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
@@ -20,7 +22,7 @@ import fg from "fast-glob";
 * Main audit function: scans all .md files in "en/" (unless you specified DOC_LIST),
 * then audits them to each locale in LOCALE_LIST.
 */
-const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale, aiOptions, nbSimultaneousFileProcessed, configOptions, customInstructions, skipIfModifiedBefore, skipIfModifiedAfter, skipIfExists, gitOptions, log }) => {
+const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale, aiOptions, nbSimultaneousFileProcessed, configOptions, customInstructions, skipIfModifiedBefore, skipIfModifiedAfter, skipIfExists, gitOptions, mode = "apply" }) => {
 	const configuration = getConfiguration(configOptions);
 	logConfigDetails(configOptions);
 	const appLogger = getAppLogger({ log: {
@@ -29,16 +31,16 @@ const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale,
 	} });
 	let aiClient;
 	let aiConfig;
-	if (!log) {
+	if (mode === "apply") {
 		const aiResult = await setupAI(configuration, aiOptions);
-		if (!aiResult?.hasAIAccess) return;
+		if (!aiResult?.hasAIAccess) return [];
 		aiClient = aiResult.aiClient;
 		aiConfig = aiResult.aiConfig;
 		if (aiResult.isCustomAI && aiClient && aiConfig) {
 			const { hasAIAccess, error } = await aiClient.checkAISDKAccess(aiConfig);
 			if (!hasAIAccess) {
 				appLogger(`${x} ${error}`);
-				return;
+				return [];
 			}
 		}
 	}
@@ -55,13 +57,25 @@ const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale,
 	appLogger(`Reviewing ${colorizeNumber(locales.length)} locales: [ ${formatLocale(locales)} ]`);
 	appLogger(`Reviewing ${colorizeNumber(docList.length)} files:`);
 	appLogger(docList.map((path) => ` - ${formatPath(path)}\n`));
-	await parallelize(docList.flatMap((docPath) => locales.map((locale) => async () => {
-		appLogger(`Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`);
+	const logProgress = (...content) => {
+		if (mode === "synthesis") return;
+		appLogger(...content);
+	};
+	const reviewResults = [];
+	/** A document is up to date when no block has to be added, reviewed or removed. */
+	const getOutcome = (summary) => summary.review + summary.insertNew + summary.delete > 0 ? "toEdit" : "upToDate";
+	const allTasks = docList.flatMap((docPath) => locales.map((locale) => async () => {
+		logProgress(`Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`);
 		const absoluteBaseFilePath = join(configuration.system.baseDir, docPath);
 		const outputFilePath = getOutputFilePath(absoluteBaseFilePath, locale, baseLocale);
 		if (skipIfExists && existsSync(outputFilePath)) {
 			const relativePath = relative(configuration.system.baseDir, outputFilePath);
-			appLogger(`${colorize("⊘", ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`);
+			logProgress(`${colorize("⊘", ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`);
+			reviewResults.push({
+				docPath,
+				locale,
+				outcome: "skipped"
+			});
 			return;
 		}
 		if (existsSync(outputFilePath)) {
@@ -70,15 +84,20 @@ const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale,
 				skipIfModifiedAfter
 			});
 			if (fileModificationData.isSkipped) {
-				appLogger(fileModificationData.message);
+				logProgress(fileModificationData.message);
+				reviewResults.push({
+					docPath,
+					locale,
+					outcome: "skipped"
+				});
 				return;
 			}
-		} else if (skipIfModifiedBefore || skipIfModifiedAfter) appLogger(`${colorize("!", ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`);
+		} else if (skipIfModifiedBefore || skipIfModifiedAfter) logProgress(`${colorize("!", ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`);
 		let changedLines;
 		if (gitOptions) {
 			const gitChangedLines = await listGitLines(absoluteBaseFilePath, gitOptions);
 			changedLines = gitChangedLines;
-			appLogger(`Changed lines (${formatLocale(baseLocale)}): ${formatLineRanges(gitChangedLines)}`);
+			logProgress(`Changed lines (${formatLocale(baseLocale)}): ${formatLineRanges(gitChangedLines)}`);
 			const { blocks } = buildReviewReport({
 				baseText: await readFile(absoluteBaseFilePath, "utf-8").catch(() => ""),
 				targetText: existsSync(outputFilePath) ? await readFile(outputFilePath, "utf-8").catch(() => "") : "",
@@ -89,14 +108,37 @@ const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale,
 				const { start, end } = block.targetLineRange;
 				return Array.from({ length: end - start + 1 }, (_unused, offset) => start + offset);
 			});
-			appLogger(`Corresponding block (${formatLocale(locale)}): ${formatLineRanges(correspondingTargetLines)}`);
+			logProgress(`Corresponding block (${formatLocale(locale)}): ${formatLineRanges(correspondingTargetLines)}`);
 		}
-		if (log) {
-			await logReviewFileBlocks(absoluteBaseFilePath, outputFilePath, locale, baseLocale, configOptions, changedLines);
+		if (mode !== "apply") {
+			const report = await buildFileReviewReport(absoluteBaseFilePath, outputFilePath, changedLines);
+			if (mode === "report") logReviewFileBlocks(report, absoluteBaseFilePath, locale, baseLocale, configOptions);
+			reviewResults.push({
+				docPath,
+				locale,
+				outcome: getOutcome(report.summary),
+				summary: report.summary
+			});
 			return;
 		}
-		await reviewFileBlockAware(absoluteBaseFilePath, outputFilePath, locale, baseLocale, aiOptions, configOptions, customInstructions, changedLines, aiClient, aiConfig);
-	})), (task) => task(), nbSimultaneousFileProcessed ?? 3);
+		const reviewSummary = await reviewFileBlockAware(absoluteBaseFilePath, outputFilePath, locale, baseLocale, aiOptions, configOptions, customInstructions, changedLines, aiClient, aiConfig);
+		reviewResults.push({
+			docPath,
+			locale,
+			outcome: getOutcome(reviewSummary),
+			summary: reviewSummary
+		});
+	}));
+	const progressLogger = createReviewProgressLogger(allTasks.length);
+	if (mode === "synthesis") progressLogger.start();
+	await parallelize(allTasks, async (task) => {
+		await task();
+		progressLogger.increment();
+	}, nbSimultaneousFileProcessed ?? 3);
+	progressLogger.stop();
+	const synthesis = formatReviewSynthesis(reviewResults, { hasAppliedChanges: mode === "apply" });
+	for (const line of synthesis.split("\n")) appLogger(line);
+	return reviewResults;
 };
 
 //#endregion

package/dist/esm/reviewDoc/reviewDoc.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDoc.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n  x,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  listGitLines,\n  logConfigDetails,\n} from '@intlayer/engine/cli';\nimport { buildReviewReport } from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath, parallelize } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\nimport { checkFileModifiedRange } from '../utils/checkFileModifiedRange';\nimport { formatLineRanges } from '../utils/formatLineRanges';\nimport { getOutputFilePath } from '../utils/getOutputFilePath';\nimport { type AIClient, setupAI } from '../utils/setupAI';\nimport { reviewFileBlockAware } from './reviewDocBlockAware';\nimport { logReviewFileBlocks } from './reviewDocLog';\n\ntype ReviewDocOptions = {\n  docPattern: string[];\n  locales: Locale[];\n  excludedGlobPattern: string[];\n  baseLocale: Locale;\n  aiOptions?: AIOptions;\n  nbSimultaneousFileProcessed?: number;\n  configOptions?: GetConfigurationOptions;\n  customInstructions?: string;\n  skipIfModifiedBefore?: number | string | Date;\n  skipIfModifiedAfter?: number | string | Date;\n  skipIfExists?: boolean;\n  gitOptions?: ListGitFilesOptions;\n  /**\n   * Log-only mode. Instead of translating the changed blocks with AI, log the\n   * blocks that need attention (with line numbers and content) for the base and\n   * target locales, so another agent can generate the translations.\n   */\n  log?: boolean;\n};\n\n/**\n * Main audit function: scans all .md files in \"en/\" (unless you specified DOC_LIST),\n * then audits them to each locale in LOCALE_LIST.\n */\nexport const reviewDoc = async ({\n  docPattern,\n  locales,\n  excludedGlobPattern,\n  baseLocale,\n  aiOptions,\n  nbSimultaneousFileProcessed,\n  configOptions,\n  customInstructions,\n  skipIfModifiedBefore,\n  skipIfModifiedAfter,\n  skipIfExists,\n  gitOptions,\n  log,\n}: ReviewDocOptions) => {\n  const configuration = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger({ log: { ...configuration.log, prefix: '' } });\n\n  // Log-only mode does not call any AI, so the AI access checks are skipped.\n  let aiClient: AIClient | undefined;\n  let aiConfig: AIConfig | undefined;\n\n  if (!log) {\n    const aiResult = await setupAI(configuration, aiOptions);\n\n    if (!aiResult?.hasAIAccess) return;\n\n    aiClient = aiResult.aiClient;\n    aiConfig = aiResult.aiConfig;\n\n    if (aiResult.isCustomAI && aiClient && aiConfig) {\n      const { hasAIAccess, error } = await aiClient.checkAISDKAccess(aiConfig);\n      if (!hasAIAccess) {\n        appLogger(`${x} ${error}`);\n        return;\n      }\n    }\n  }\n\n  if (nbSimultaneousFileProcessed && nbSimultaneousFileProcessed > 10) {\n    appLogger(\n      `Warning: nbSimultaneousFileProcessed is set to ${nbSimultaneousFileProcessed}, which is greater than 10. Setting it to 10.`\n    );\n    nbSimultaneousFileProcessed = 10; // Limit the number of simultaneous file processed to 10\n  }\n\n  let docList: string[] = await fg(docPattern, {\n    ignore: excludedGlobPattern,\n  });\n\n  if (gitOptions) {\n    const gitChangedFiles = await listGitFiles(gitOptions);\n\n    if (gitChangedFiles) {\n      // Convert dictionary file paths to be relative to git root for comparison\n\n      // Filter dictionaries based on git changed files\n      docList = docList.filter((path) =>\n        gitChangedFiles.some((gitFile) => join(process.cwd(), path) === gitFile)\n      );\n    }\n  }\n\n  // OAuth handled by API proxy internally\n\n  appLogger(`Base locale is ${formatLocale(baseLocale)}`);\n  appLogger(\n    `Reviewing ${colorizeNumber(locales.length)} locales: [ ${formatLocale(locales)} ]`\n  );\n\n  appLogger(`Reviewing ${colorizeNumber(docList.length)} files:`);\n  appLogger(docList.map((path) => ` - ${formatPath(path)}\\n`));\n\n  // Create all tasks to be processed\n  const allTasks = docList.flatMap((docPath) =>\n    locales.map((locale) => async () => {\n      appLogger(\n        `Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`\n      );\n\n      const absoluteBaseFilePath = join(configuration.system.baseDir, docPath);\n      const outputFilePath = getOutputFilePath(\n        absoluteBaseFilePath,\n        locale,\n        baseLocale\n      );\n\n      // Skip if file exists and skipIfExists option is enabled\n      if (skipIfExists && existsSync(outputFilePath)) {\n        const relativePath = relative(\n          configuration.system.baseDir,\n          outputFilePath\n        );\n        appLogger(\n          `${colorize('⊘', ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`\n        );\n        return;\n      }\n\n      // Check modification range only if the file exists\n      if (existsSync(outputFilePath)) {\n        const fileModificationData = checkFileModifiedRange(outputFilePath, {\n          skipIfModifiedBefore,\n          skipIfModifiedAfter,\n        });\n\n        if (fileModificationData.isSkipped) {\n          appLogger(fileModificationData.message);\n          return;\n        }\n      } else if (skipIfModifiedBefore || skipIfModifiedAfter) {\n        // Log if we intended to check modification time but couldn't because the file doesn't exist\n        appLogger(\n          `${colorize('!', ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`\n        );\n      }\n\n      let changedLines: number[] | undefined;\n      // FIXED: Enable git optimization that was previously commented out\n      if (gitOptions) {\n        const gitChangedLines = await listGitLines(\n          absoluteBaseFilePath,\n          gitOptions\n        );\n        changedLines = gitChangedLines;\n\n        // Report the base lines that changed, then the corresponding line span\n        // in the target document — i.e. the blocks the alignment will actually\n        // re-translate. `review` blocks are exactly the aligned base blocks the\n        // changed lines touched, so their `targetLineRange` is the matching span\n        // in the existing translation.\n        appLogger(\n          `Changed lines (${formatLocale(baseLocale)}): ${formatLineRanges(gitChangedLines)}`\n        );\n\n        const baseText = await readFile(absoluteBaseFilePath, 'utf-8').catch(\n          () => ''\n        );\n        const targetText = existsSync(outputFilePath)\n          ? await readFile(outputFilePath, 'utf-8').catch(() => '')\n          : '';\n\n        const { blocks } = buildReviewReport({\n          baseText,\n          targetText,\n          changedLines: gitChangedLines,\n        });\n\n        const correspondingTargetLines = blocks.flatMap((block) => {\n          if (block.action !== 'review' || !block.targetLineRange) return [];\n\n          const { start, end } = block.targetLineRange;\n          return Array.from(\n            { length: end - start + 1 },\n            (_unused, offset) => start + offset\n          );\n        });\n\n        appLogger(\n          `Corresponding block (${formatLocale(locale)}): ${formatLineRanges(correspondingTargetLines)}`\n        );\n      }\n\n      if (log) {\n        await logReviewFileBlocks(\n          absoluteBaseFilePath,\n          outputFilePath,\n          locale as Locale,\n          baseLocale,\n          configOptions,\n          changedLines\n        );\n        return;\n      }\n\n      await reviewFileBlockAware(\n        absoluteBaseFilePath,\n        outputFilePath,\n        locale as Locale,\n        baseLocale,\n        aiOptions,\n        configOptions,\n        customInstructions,\n        changedLines,\n        aiClient,\n        aiConfig\n      );\n    })\n  );\n\n  await parallelize(\n    allTasks,\n    (task) => task(),\n    nbSimultaneousFileProcessed ?? 3\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"reviewDoc.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n  x,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  listGitLines,\n  logConfigDetails,\n} from '@intlayer/engine/cli';\nimport {\n  buildReviewReport,\n  type ReviewReportSummary,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath, parallelize } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\nimport { checkFileModifiedRange } from '../utils/checkFileModifiedRange';\nimport { formatLineRanges } from '../utils/formatLineRanges';\nimport { getOutputFilePath } from '../utils/getOutputFilePath';\nimport { type AIClient, setupAI } from '../utils/setupAI';\nimport { reviewFileBlockAware } from './reviewDocBlockAware';\nimport { buildFileReviewReport, logReviewFileBlocks } from './reviewDocLog';\nimport { createReviewProgressLogger } from './reviewDocProgress';\nimport {\n  formatReviewSynthesis,\n  type ReviewFileResult,\n  type ReviewOutcome,\n} from './reviewDocSynthesis';\n\n/**\n * How the review should be run.\n *\n * - `apply`: translate the diverging blocks with AI and write the target files.\n * - `report`: no AI. Log every block that needs attention (line numbers and\n *   content, for both locales) so another agent can generate the translations.\n * - `synthesis`: no AI, no per-block output. Only log the final synthesis of the\n *   documents that are up to date and the ones that still have blocks to edit.\n */\nexport type ReviewDocMode = 'apply' | 'report' | 'synthesis';\n\ntype ReviewDocOptions = {\n  docPattern: string[];\n  locales: Locale[];\n  excludedGlobPattern: string[];\n  baseLocale: Locale;\n  aiOptions?: AIOptions;\n  nbSimultaneousFileProcessed?: number;\n  configOptions?: GetConfigurationOptions;\n  customInstructions?: string;\n  skipIfModifiedBefore?: number | string | Date;\n  skipIfModifiedAfter?: number | string | Date;\n  skipIfExists?: boolean;\n  gitOptions?: ListGitFilesOptions;\n  /** How the review should be run. Defaults to `apply`. See {@link ReviewDocMode}. */\n  mode?: ReviewDocMode;\n};\n\n/**\n * Main audit function: scans all .md files in \"en/\" (unless you specified DOC_LIST),\n * then audits them to each locale in LOCALE_LIST.\n */\nexport const reviewDoc = async ({\n  docPattern,\n  locales,\n  excludedGlobPattern,\n  baseLocale,\n  aiOptions,\n  nbSimultaneousFileProcessed,\n  configOptions,\n  customInstructions,\n  skipIfModifiedBefore,\n  skipIfModifiedAfter,\n  skipIfExists,\n  gitOptions,\n  mode = 'apply',\n}: ReviewDocOptions) => {\n  const configuration = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger({ log: { ...configuration.log, prefix: '' } });\n\n  // The `report` and `synthesis` modes never call an AI, so the AI access\n  // checks are skipped.\n  let aiClient: AIClient | undefined;\n  let aiConfig: AIConfig | undefined;\n\n  if (mode === 'apply') {\n    const aiResult = await setupAI(configuration, aiOptions);\n\n    if (!aiResult?.hasAIAccess) return [];\n\n    aiClient = aiResult.aiClient;\n    aiConfig = aiResult.aiConfig;\n\n    if (aiResult.isCustomAI && aiClient && aiConfig) {\n      const { hasAIAccess, error } = await aiClient.checkAISDKAccess(aiConfig);\n      if (!hasAIAccess) {\n        appLogger(`${x} ${error}`);\n        return [];\n      }\n    }\n  }\n\n  if (nbSimultaneousFileProcessed && nbSimultaneousFileProcessed > 10) {\n    appLogger(\n      `Warning: nbSimultaneousFileProcessed is set to ${nbSimultaneousFileProcessed}, which is greater than 10. Setting it to 10.`\n    );\n    nbSimultaneousFileProcessed = 10; // Limit the number of simultaneous file processed to 10\n  }\n\n  let docList: string[] = await fg(docPattern, {\n    ignore: excludedGlobPattern,\n  });\n\n  if (gitOptions) {\n    const gitChangedFiles = await listGitFiles(gitOptions);\n\n    if (gitChangedFiles) {\n      // Convert dictionary file paths to be relative to git root for comparison\n\n      // Filter dictionaries based on git changed files\n      docList = docList.filter((path) =>\n        gitChangedFiles.some((gitFile) => join(process.cwd(), path) === gitFile)\n      );\n    }\n  }\n\n  // OAuth handled by API proxy internally\n\n  appLogger(`Base locale is ${formatLocale(baseLocale)}`);\n  appLogger(\n    `Reviewing ${colorizeNumber(locales.length)} locales: [ ${formatLocale(locales)} ]`\n  );\n\n  appLogger(`Reviewing ${colorizeNumber(docList.length)} files:`);\n  appLogger(docList.map((path) => ` - ${formatPath(path)}\\n`));\n\n  // In `synthesis` mode only the final recap is printed, so the per-file\n  // progress logs are muted.\n  const logProgress: typeof appLogger = (...content) => {\n    if (mode === 'synthesis') return;\n    appLogger(...content);\n  };\n\n  // Filled by every task, then rendered as the end-of-run synthesis.\n  const reviewResults: ReviewFileResult[] = [];\n\n  /** A document is up to date when no block has to be added, reviewed or removed. */\n  const getOutcome = (summary: ReviewReportSummary): ReviewOutcome =>\n    summary.review + summary.insertNew + summary.delete > 0\n      ? 'toEdit'\n      : 'upToDate';\n\n  // Create all tasks to be processed\n  const allTasks = docList.flatMap((docPath) =>\n    locales.map((locale) => async () => {\n      logProgress(\n        `Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`\n      );\n\n      const absoluteBaseFilePath = join(configuration.system.baseDir, docPath);\n      const outputFilePath = getOutputFilePath(\n        absoluteBaseFilePath,\n        locale,\n        baseLocale\n      );\n\n      // Skip if file exists and skipIfExists option is enabled\n      if (skipIfExists && existsSync(outputFilePath)) {\n        const relativePath = relative(\n          configuration.system.baseDir,\n          outputFilePath\n        );\n        logProgress(\n          `${colorize('⊘', ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`\n        );\n        reviewResults.push({ docPath, locale, outcome: 'skipped' });\n        return;\n      }\n\n      // Check modification range only if the file exists\n      if (existsSync(outputFilePath)) {\n        const fileModificationData = checkFileModifiedRange(outputFilePath, {\n          skipIfModifiedBefore,\n          skipIfModifiedAfter,\n        });\n\n        if (fileModificationData.isSkipped) {\n          logProgress(fileModificationData.message);\n          reviewResults.push({ docPath, locale, outcome: 'skipped' });\n          return;\n        }\n      } else if (skipIfModifiedBefore || skipIfModifiedAfter) {\n        // Log if we intended to check modification time but couldn't because the file doesn't exist\n        logProgress(\n          `${colorize('!', ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`\n        );\n      }\n\n      let changedLines: number[] | undefined;\n      // FIXED: Enable git optimization that was previously commented out\n      if (gitOptions) {\n        const gitChangedLines = await listGitLines(\n          absoluteBaseFilePath,\n          gitOptions\n        );\n        changedLines = gitChangedLines;\n\n        // Report the base lines that changed, then the corresponding line span\n        // in the target document — i.e. the blocks the alignment will actually\n        // re-translate. `review` blocks are exactly the aligned base blocks the\n        // changed lines touched, so their `targetLineRange` is the matching span\n        // in the existing translation.\n        logProgress(\n          `Changed lines (${formatLocale(baseLocale)}): ${formatLineRanges(gitChangedLines)}`\n        );\n\n        const baseText = await readFile(absoluteBaseFilePath, 'utf-8').catch(\n          () => ''\n        );\n        const targetText = existsSync(outputFilePath)\n          ? await readFile(outputFilePath, 'utf-8').catch(() => '')\n          : '';\n\n        const { blocks } = buildReviewReport({\n          baseText,\n          targetText,\n          changedLines: gitChangedLines,\n        });\n\n        const correspondingTargetLines = blocks.flatMap((block) => {\n          if (block.action !== 'review' || !block.targetLineRange) return [];\n\n          const { start, end } = block.targetLineRange;\n          return Array.from(\n            { length: end - start + 1 },\n            (_unused, offset) => start + offset\n          );\n        });\n\n        logProgress(\n          `Corresponding block (${formatLocale(locale)}): ${formatLineRanges(correspondingTargetLines)}`\n        );\n      }\n\n      if (mode !== 'apply') {\n        const report = await buildFileReviewReport(\n          absoluteBaseFilePath,\n          outputFilePath,\n          changedLines\n        );\n\n        if (mode === 'report') {\n          logReviewFileBlocks(\n            report,\n            absoluteBaseFilePath,\n            locale as Locale,\n            baseLocale,\n            configOptions\n          );\n        }\n\n        reviewResults.push({\n          docPath,\n          locale,\n          outcome: getOutcome(report.summary),\n          summary: report.summary,\n        });\n        return;\n      }\n\n      const reviewSummary = await reviewFileBlockAware(\n        absoluteBaseFilePath,\n        outputFilePath,\n        locale as Locale,\n        baseLocale,\n        aiOptions,\n        configOptions,\n        customInstructions,\n        changedLines,\n        aiClient,\n        aiConfig\n      );\n\n      reviewResults.push({\n        docPath,\n        locale,\n        outcome: getOutcome(reviewSummary),\n        summary: reviewSummary,\n      });\n    })\n  );\n\n  // The per-file logs are muted in `synthesis` mode, so a progress line keeps\n  // the run readable while every document is compared.\n  const progressLogger = createReviewProgressLogger(allTasks.length);\n\n  if (mode === 'synthesis') progressLogger.start();\n\n  await parallelize(\n    allTasks,\n    async (task) => {\n      await task();\n      progressLogger.increment();\n    },\n    nbSimultaneousFileProcessed ?? 3\n  );\n\n  progressLogger.stop();\n\n  const synthesis = formatReviewSynthesis(reviewResults, {\n    hasAppliedChanges: mode === 'apply',\n  });\n\n  for (const line of synthesis.split('\\n')) {\n    appLogger(line);\n  }\n\n  return reviewResults;\n};\n"],"mappings":"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"}

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs

@@ -25,6 +25,9 @@ import { ENGLISH } from "@intlayer/types/locales";
 * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so
 *    line numbers of earlier blocks are not shifted by edits below them.
 * 6. Rewrites the file after each block so progress is persisted incrementally.
+*
+* @returns The per-action block counts of the alignment plan, so the caller can
+* synthesize what was reused and what had to be edited.
 */
 const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLocale, aiOptions, configOptions, customInstructions, changedLines, aiClient, aiConfig) => {
 	const configuration = getConfiguration(configOptions);
@@ -42,9 +45,16 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 		targetText,
 		changedLines
 	});
-	const deleteCount = plan.actions.filter((a) => a.kind === "delete").length;
+	const countActions = (kind) => plan.actions.filter((action) => action.kind === kind).length;
+	const reviewSummary = {
+		reuse: countActions("reuse"),
+		review: countActions("review"),
+		insertNew: countActions("insert_new"),
+		delete: countActions("delete")
+	};
+	const deleteCount = reviewSummary.delete;
 	applicationLogger(`${filePrefix}Block-aware alignment complete. Total blocks: base=${colorizeNumber(baseBlocks.length)}, target=${colorizeNumber(targetBlocks.length)}`);
-	applicationLogger(`${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === "reuse").length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === "review").length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === "insert_new").length)}, delete=${colorizeNumber(deleteCount)}`);
+	applicationLogger(`${filePrefix}Actions: reuse=${colorizeNumber(reviewSummary.reuse)}, review=${colorizeNumber(reviewSummary.review)}, new=${colorizeNumber(reviewSummary.insertNew)}, delete=${colorizeNumber(deleteCount)}`);
 	const reviewedSegmentsMap = /* @__PURE__ */ new Map();
 	for (const [actionIndex, action] of plan.actions.entries()) if (action.kind === "delete") reviewedSegmentsMap.set(actionIndex, "");
 	const writeCurrentState = () => {
@@ -62,7 +72,7 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 			writeCurrentState();
 		}
 		applicationLogger(`${colorize("✔", ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no AI changes needed).`);
-		return;
+		return reviewSummary;
 	}
 	applicationLogger(`${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`);
 	const segmentsBottomUp = segmentsToReview.map((segment, originalIndex) => ({
@@ -105,6 +115,7 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 		writeCurrentState();
 	}
 	applicationLogger(`${colorize("✔", ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`);
+	return reviewSummary;
 };
 
 //#endregion

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDocBlockAware.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n *\n * 1. Segments both base and target documents into semantic blocks.\n * 2. Aligns blocks using structure (special chars, numbers) and context.\n * 3. Detects which blocks changed, were added, or deleted.\n * 4. Applies deletions immediately without AI.\n * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so\n *    line numbers of earlier blocks are not shifted by edits below them.\n * 6. Rewrites the file after each block so progress is persisted incrementally.\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n) => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger({\n    log: { ...configuration.log, prefix: '' },\n  });\n\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { baseBlocks, targetBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      baseText,\n      targetText,\n      changedLines,\n    });\n\n  const deleteCount = plan.actions.filter((a) => a.kind === 'delete').length;\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: base=${colorizeNumber(baseBlocks.length)}, target=${colorizeNumber(targetBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === 'reuse').length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === 'review').length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === 'insert_new').length)}, delete=${colorizeNumber(deleteCount)}`\n  );\n\n  // Map shared across the entire run: each entry overrides the default behavior\n  // of mergeReviewedSegments for that action index.\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  // --- Step 1: apply deletions immediately (no AI needed) ---\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'delete') {\n      reviewedSegmentsMap.set(actionIndex, '');\n    }\n  }\n\n  const writeCurrentState = (): void => {\n    const output = mergeReviewedSegments(\n      plan,\n      targetBlocks,\n      reviewedSegmentsMap\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(outputFilePath, output);\n  };\n\n  if (deleteCount > 0) {\n    writeCurrentState();\n    applicationLogger(\n      `${filePrefix}${colorizeNumber(deleteCount)} block(s) deleted without AI.`\n    );\n  }\n\n  if (segmentsToReview.length === 0) {\n    if (deleteCount === 0) {\n      applicationLogger(\n        `${filePrefix}No segments need review, reusing existing translation`\n      );\n      writeCurrentState();\n    }\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no AI changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`\n  );\n\n  // --- Step 2: process AI segments in bottom-up order ---\n  // Reversing ensures edits near the end of the file don't shift line numbers\n  // that matter for blocks higher up, and each intermediate file write is valid.\n  const segmentsBottomUp = segmentsToReview\n    .map((segment, originalIndex) => ({\n      segment,\n      displayNumber: originalIndex + 1,\n    }))\n    .reverse();\n\n  for (const { segment, displayNumber } of segmentsBottomUp) {\n    const baseBlock = segment.baseBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      baseBlock.content +\n      `///chunksEnd///`;\n\n    const getTargetChunkPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.targetBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getTargetChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: baseBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        baseBlock.content\n      );\n      processedChunk = fixChunkStartEndChars(processedChunk, baseBlock.content);\n\n      const isValid = validateTranslation(\n        baseBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n\n    // Rewrite the file after every block so progress is never lost.\n    writeCurrentState();\n  }\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAa,uBAAuB,OAClC,cACA,gBACA,QACA,YACA,WACA,eACA,oBACA,cACA,UACA,aACG;CACH,MAAM,gBAAgB,iBAAiB,aAAa;CACpD,MAAM,oBAAoB,aAAa,EACrC,KAAK;EAAE,GAAG,cAAc;EAAK,QAAQ;CAAG,EAC1C,CAAC;CAED,MAAM,WAAW,MAAM,SAAS,cAAc,OAAO;CACrD,MAAM,aAAa,MAAM,SAAS,gBAAgB,OAAO,CAAC,CAAC,YAAY,EAAE;CAEzE,MAAM,aAAa,UAAU,8BAA8B,OAAO,CAAC,CAChE,WAAW,kBAAkB,GAAG,aAAa,QAAQ,KAAK,GAAG,CAAC,CAC9D,WAAW,sBAAsB,GAAG,aAAa,YAAY,KAAK,GAAG,CAAC,CACtE,QAAQ,0BAA0B,WAAW,sBAAsB,GAAG,CAAC,CACvE,QAAQ,0BAA0B,sBAAsB,GAAG;CAG9D,MAAM,aAAa,CACjB,MAAM,GAFkB,WAAW,UAAU,GAAG,WAAW,YAAY,IAAI,WAAW,UAAU,KAE1E,EAAE,SAAS,GAAG,CAAC,GACrC,KAAK,WAAW,OAClB,CAAC,CAAC,KAAK,EAAE;CAET,MAAM,SAAS,CACb,MAAM,GAFc,WAAW,UAAU,GAAG,WAAW,YAAY,IAAI,WAAW,UAAU,IAAI,aAAa,MAAM,IAAI,WAAW,UAAU,KAE1H,EAAE,SAAS,GAAG,CAAC,GACjC,KAAK,WAAW,OAClB,CAAC,CAAC,KAAK,EAAE;CAGT,MAAM,EAAE,YAAY,cAAc,MAAM,qBACtC,mBAAmB;EACjB;EACA;EACA;CACF,CAAC;CAEH,MAAM,cAAc,KAAK,QAAQ,QAAQ,MAAM,EAAE,SAAS,QAAQ,CAAC,CAAC;CAEpE,kBACE,GAAG,WAAW,qDAAqD,eAAe,WAAW,MAAM,EAAE,WAAW,eAAe,aAAa,MAAM,GACpJ;CACA,kBACE,GAAG,WAAW,iBAAiB,eAAe,KAAK,QAAQ,QAAQ,MAAM,EAAE,SAAS,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,eAAe,KAAK,QAAQ,QAAQ,MAAM,EAAE,SAAS,QAAQ,CAAC,CAAC,MAAM,EAAE,QAAQ,eAAe,KAAK,QAAQ,QAAQ,MAAM,EAAE,SAAS,YAAY,CAAC,CAAC,MAAM,EAAE,WAAW,eAAe,WAAW,GACjT;CAIA,MAAM,sCAAsB,IAAI,IAAoB;CAGpD,KAAK,MAAM,CAAC,aAAa,WAAW,KAAK,QAAQ,QAAQ,GACvD,IAAI,OAAO,SAAS,UAClB,oBAAoB,IAAI,aAAa,EAAE;CAI3C,MAAM,0BAAgC;EACpC,MAAM,SAAS,sBACb,MACA,cACA,mBACF;EACA,UAAU,QAAQ,cAAc,GAAG,EAAE,WAAW,KAAK,CAAC;EACtD,cAAc,gBAAgB,MAAM;CACtC;CAEA,IAAI,cAAc,GAAG;EACnB,kBAAkB;EAClB,kBACE,GAAG,aAAa,eAAe,WAAW,EAAE,8BAC9C;CACF;CAEA,IAAI,iBAAiB,WAAW,GAAG;EACjC,IAAI,gBAAgB,GAAG;GACrB,kBACE,GAAG,WAAW,sDAChB;GACA,kBAAkB;EACpB;EACA,kBACE,GAAG,SAAS,KAAK,WAAW,KAAK,EAAE,QAAQ,WAAW,cAAc,EAAE,8CACxE;EACA;CACF;CAEA,kBACE,GAAG,WAAW,sBAAsB,eAAe,iBAAiB,MAAM,EAAE,wBAC9E;CAKA,MAAM,mBAAmB,iBACtB,KAAK,SAAS,mBAAmB;EAChC;EACA,eAAe,gBAAgB;CACjC,EAAE,CAAC,CACF,QAAQ;CAEX,KAAK,MAAM,EAAE,SAAS,mBAAmB,kBAAkB;EACzD,MAAM,YAAY,QAAQ;EAE1B,MAAM,kCACJ,WAAW,cAAc,MAAM,iBAAiB,OAAO,0BAA0B,aAAa,YAAY,KAAK,EAAE,uCAEjH,UAAU,UACV;EAEF,MAAM,6BACJ,WAAW,cAAc,MAAM,iBAAiB,OAAO,uCAAuC,aAAa,QAAQ,KAAK,EAAE,2BAEzH,QAAQ,mBAAmB,MAC5B;EAEF,MAAM,sBAAsB,MAAM,aAAa,YAAY;GACzD,MAAM,SAAS,MAAM,eACnB;IACE;KAAE,MAAM;KAAU,SAAS;IAAW;IACtC;KAAE,MAAM;KAAU,SAAS,0BAA0B;IAAE;IACvD;KAAE,MAAM;KAAU,SAAS,qBAAqB;IAAE;IAClD;KACE,MAAM;KACN,SAAS,6CAA6C,eAAe,aAAa,EAAE,MAAM,eAAe,iBAAiB,MAAM,EAAE,kCAAkC,cAAc,QAAQ,OAAO,EAAE,IAAI,OAAO;IAChN;GACF,GACA,CAAC;IAAE,MAAM;IAAQ,SAAS,UAAU;GAAQ,CAAC,GAC7C,WACA,eACA,UACA,QACF;GAEA,kBACE,GAAG,SAAS,eAAe,OAAO,SAAS,EAAE,uBAAuB,eAAe,aAAa,EAAE,MAAM,eAAe,iBAAiB,MAAM,GAChJ;GAEA,IAAI,iBAAiB,cACnB,QAAQ,aACR,UAAU,OACZ;GACA,iBAAiB,sBAAsB,gBAAgB,UAAU,OAAO;GAQxE,IAAI,CANY,oBACd,UAAU,SACV,gBACA,iBAGS,GACT,MAAM,IAAI,MACR,yEACF;GAGF,OAAO;EACT,CAAC,CAAC,CAAC;EAEH,oBAAoB,IAAI,QAAQ,aAAa,mBAAmB;EAGhE,kBAAkB;CACpB;CAEA,kBACE,GAAG,SAAS,KAAK,WAAW,KAAK,EAAE,QAAQ,WAAW,cAAc,EAAE,+BACxE;AACF"}
+{"version":3,"file":"reviewDocBlockAware.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n  type PlannedAction,\n  type ReviewReportSummary,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n *\n * 1. Segments both base and target documents into semantic blocks.\n * 2. Aligns blocks using structure (special chars, numbers) and context.\n * 3. Detects which blocks changed, were added, or deleted.\n * 4. Applies deletions immediately without AI.\n * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so\n *    line numbers of earlier blocks are not shifted by edits below them.\n * 6. Rewrites the file after each block so progress is persisted incrementally.\n *\n * @returns The per-action block counts of the alignment plan, so the caller can\n * synthesize what was reused and what had to be edited.\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n): Promise<ReviewReportSummary> => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger({\n    log: { ...configuration.log, prefix: '' },\n  });\n\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { baseBlocks, targetBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      baseText,\n      targetText,\n      changedLines,\n    });\n\n  const countActions = (kind: PlannedAction['kind']): number =>\n    plan.actions.filter((action: PlannedAction) => action.kind === kind).length;\n\n  const reviewSummary: ReviewReportSummary = {\n    reuse: countActions('reuse'),\n    review: countActions('review'),\n    insertNew: countActions('insert_new'),\n    delete: countActions('delete'),\n  };\n\n  const deleteCount = reviewSummary.delete;\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: base=${colorizeNumber(baseBlocks.length)}, target=${colorizeNumber(targetBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(reviewSummary.reuse)}, review=${colorizeNumber(reviewSummary.review)}, new=${colorizeNumber(reviewSummary.insertNew)}, delete=${colorizeNumber(deleteCount)}`\n  );\n\n  // Map shared across the entire run: each entry overrides the default behavior\n  // of mergeReviewedSegments for that action index.\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  // --- Step 1: apply deletions immediately (no AI needed) ---\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'delete') {\n      reviewedSegmentsMap.set(actionIndex, '');\n    }\n  }\n\n  const writeCurrentState = (): void => {\n    const output = mergeReviewedSegments(\n      plan,\n      targetBlocks,\n      reviewedSegmentsMap\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(outputFilePath, output);\n  };\n\n  if (deleteCount > 0) {\n    writeCurrentState();\n    applicationLogger(\n      `${filePrefix}${colorizeNumber(deleteCount)} block(s) deleted without AI.`\n    );\n  }\n\n  if (segmentsToReview.length === 0) {\n    if (deleteCount === 0) {\n      applicationLogger(\n        `${filePrefix}No segments need review, reusing existing translation`\n      );\n      writeCurrentState();\n    }\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no AI changes needed).`\n    );\n    return reviewSummary;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`\n  );\n\n  // --- Step 2: process AI segments in bottom-up order ---\n  // Reversing ensures edits near the end of the file don't shift line numbers\n  // that matter for blocks higher up, and each intermediate file write is valid.\n  const segmentsBottomUp = segmentsToReview\n    .map((segment, originalIndex) => ({\n      segment,\n      displayNumber: originalIndex + 1,\n    }))\n    .reverse();\n\n  for (const { segment, displayNumber } of segmentsBottomUp) {\n    const baseBlock = segment.baseBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      baseBlock.content +\n      `///chunksEnd///`;\n\n    const getTargetChunkPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.targetBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getTargetChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: baseBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        baseBlock.content\n      );\n      processedChunk = fixChunkStartEndChars(processedChunk, baseBlock.content);\n\n      const isValid = validateTranslation(\n        baseBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n\n    // Rewrite the file after every block so progress is never lost.\n    writeCurrentState();\n  }\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n\n  return reviewSummary;\n};\n"],"mappings":"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"}

package/dist/esm/reviewDoc/reviewDocLog.mjs

@@ -7,40 +7,44 @@ import { buildReviewReport, formatReviewReport } from "@intlayer/engine/docRevie
 
 //#region src/reviewDoc/reviewDocLog.ts
 /**
-* Log-only review of a single file/locale pair.
-*
-* Instead of calling an AI to translate the changed blocks, this compares the
-* base document with its translation and logs the blocks that need attention
-* (with their line ranges and content) so another agent or a human can generate
-* the missing translations.
+* Compare a base document with its translation without calling any AI.
 *
 * @param baseFilePath - Absolute path of the base (source) document.
 * @param outputFilePath - Absolute path of the target (translated) document.
+* @param changedLines - 1-based base line numbers that changed (from git), if any.
+* @returns The structured review report.
+*/
+const buildFileReviewReport = async (baseFilePath, outputFilePath, changedLines) => {
+	return buildReviewReport({
+		baseText: await readFile(baseFilePath, "utf-8"),
+		targetText: existsSync(outputFilePath) ? await readFile(outputFilePath, "utf-8").catch(() => "") : "",
+		changedLines
+	});
+};
+/**
+* Log the blocks that need attention (with their line ranges and content) for a
+* single file/locale pair, so another agent or a human can generate the missing
+* translations.
+*
+* @param report - The report built by {@link buildFileReviewReport}.
+* @param baseFilePath - Absolute path of the base (source) document.
 * @param locale - The target locale being reviewed.
 * @param baseLocale - The base locale used as reference.
 * @param configOptions - Optional Intlayer configuration overrides.
-* @param changedLines - 1-based base line numbers that changed (from git), if any.
-* @returns The structured review report.
 */
-const logReviewFileBlocks = async (baseFilePath, outputFilePath, locale, baseLocale, configOptions, changedLines) => {
+const logReviewFileBlocks = (report, baseFilePath, locale, baseLocale, configOptions) => {
 	const appLogger = getAppLogger({ log: {
 		...getConfiguration(configOptions).log,
 		prefix: ""
 	} });
-	const report = buildReviewReport({
-		baseText: await readFile(baseFilePath, "utf-8"),
-		targetText: existsSync(outputFilePath) ? await readFile(outputFilePath, "utf-8").catch(() => "") : "",
-		changedLines
-	});
 	const formatted = formatReviewReport(report, {
 		baseLabel: formatLocale(baseLocale),
 		targetLabel: formatLocale(locale)
 	});
 	appLogger(`${formatPath(baseFilePath)} → ${formatLocale(locale)}`);
 	for (const line of formatted.split("\n")) appLogger(line);
-	return report;
 };
 
 //#endregion
-export { logReviewFileBlocks };
+export { buildFileReviewReport, logReviewFileBlocks };
 //# sourceMappingURL=reviewDocLog.mjs.map

package/dist/esm/reviewDoc/reviewDocLog.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDocLog.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocLog.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  buildReviewReport,\n  formatReviewReport,\n  type ReviewReport,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n\n/**\n * Log-only review of a single file/locale pair.\n *\n * Instead of calling an AI to translate the changed blocks, this compares the\n * base document with its translation and logs the blocks that need attention\n * (with their line ranges and content) so another agent or a human can generate\n * the missing translations.\n *\n * @param baseFilePath - Absolute path of the base (source) document.\n * @param outputFilePath - Absolute path of the target (translated) document.\n * @param locale - The target locale being reviewed.\n * @param baseLocale - The base locale used as reference.\n * @param configOptions - Optional Intlayer configuration overrides.\n * @param changedLines - 1-based base line numbers that changed (from git), if any.\n * @returns The structured review report.\n */\nexport const logReviewFileBlocks = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  configOptions?: GetConfigurationOptions,\n  changedLines?: number[]\n): Promise<ReviewReport> => {\n  const configuration = getConfiguration(configOptions);\n  const appLogger = getAppLogger({ log: { ...configuration.log, prefix: '' } });\n\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = existsSync(outputFilePath)\n    ? await readFile(outputFilePath, 'utf-8').catch(() => '')\n    : '';\n\n  const report = buildReviewReport({ baseText, targetText, changedLines });\n\n  const formatted = formatReviewReport(report, {\n    baseLabel: formatLocale(baseLocale),\n    targetLabel: formatLocale(locale),\n  });\n\n  appLogger(`${formatPath(baseFilePath)} → ${formatLocale(locale)}`);\n  for (const line of formatted.split('\\n')) {\n    appLogger(line);\n  }\n\n  return report;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,sBAAsB,OACjC,cACA,gBACA,QACA,YACA,eACA,iBAC0B;CAE1B,MAAM,YAAY,aAAa,EAAE,KAAK;EAAE,GADlB,iBAAiB,aACgB,CAAC,CAAC;EAAK,QAAQ;CAAG,EAAE,CAAC;CAO5E,MAAM,SAAS,kBAAkB;EAAE,gBALZ,SAAS,cAAc,OAAO;EAKR,YAJ1B,WAAW,cAAc,IACxC,MAAM,SAAS,gBAAgB,OAAO,CAAC,CAAC,YAAY,EAAE,IACtD;EAEqD;CAAa,CAAC;CAEvE,MAAM,YAAY,mBAAmB,QAAQ;EAC3C,WAAW,aAAa,UAAU;EAClC,aAAa,aAAa,MAAM;CAClC,CAAC;CAED,UAAU,GAAG,WAAW,YAAY,EAAE,KAAK,aAAa,MAAM,GAAG;CACjE,KAAK,MAAM,QAAQ,UAAU,MAAM,IAAI,GACrC,UAAU,IAAI;CAGhB,OAAO;AACT"}
+{"version":3,"file":"reviewDocLog.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocLog.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  buildReviewReport,\n  formatReviewReport,\n  type ReviewReport,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n\n/**\n * Compare a base document with its translation without calling any AI.\n *\n * @param baseFilePath - Absolute path of the base (source) document.\n * @param outputFilePath - Absolute path of the target (translated) document.\n * @param changedLines - 1-based base line numbers that changed (from git), if any.\n * @returns The structured review report.\n */\nexport const buildFileReviewReport = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  changedLines?: number[]\n): Promise<ReviewReport> => {\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = existsSync(outputFilePath)\n    ? await readFile(outputFilePath, 'utf-8').catch(() => '')\n    : '';\n\n  return buildReviewReport({ baseText, targetText, changedLines });\n};\n\n/**\n * Log the blocks that need attention (with their line ranges and content) for a\n * single file/locale pair, so another agent or a human can generate the missing\n * translations.\n *\n * @param report - The report built by {@link buildFileReviewReport}.\n * @param baseFilePath - Absolute path of the base (source) document.\n * @param locale - The target locale being reviewed.\n * @param baseLocale - The base locale used as reference.\n * @param configOptions - Optional Intlayer configuration overrides.\n */\nexport const logReviewFileBlocks = (\n  report: ReviewReport,\n  baseFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  configOptions?: GetConfigurationOptions\n): void => {\n  const configuration = getConfiguration(configOptions);\n  const appLogger = getAppLogger({ log: { ...configuration.log, prefix: '' } });\n\n  const formatted = formatReviewReport(report, {\n    baseLabel: formatLocale(baseLocale),\n    targetLabel: formatLocale(locale),\n  });\n\n  appLogger(`${formatPath(baseFilePath)} → ${formatLocale(locale)}`);\n  for (const line of formatted.split('\\n')) {\n    appLogger(line);\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAuBA,MAAa,wBAAwB,OACnC,cACA,gBACA,iBAC0B;CAM1B,OAAO,kBAAkB;EAAE,gBALJ,SAAS,cAAc,OAAO;EAKhB,YAJlB,WAAW,cAAc,IACxC,MAAM,SAAS,gBAAgB,OAAO,CAAC,CAAC,YAAY,EAAE,IACtD;EAE6C;CAAa,CAAC;AACjE;;;;;;;;;;;;AAaA,MAAa,uBACX,QACA,cACA,QACA,YACA,kBACS;CAET,MAAM,YAAY,aAAa,EAAE,KAAK;EAAE,GADlB,iBAAiB,aACgB,CAAC,CAAC;EAAK,QAAQ;CAAG,EAAE,CAAC;CAE5E,MAAM,YAAY,mBAAmB,QAAQ;EAC3C,WAAW,aAAa,UAAU;EAClC,aAAa,aAAa,MAAM;CAClC,CAAC;CAED,UAAU,GAAG,WAAW,YAAY,EAAE,KAAK,aAAa,MAAM,GAAG;CACjE,KAAK,MAAM,QAAQ,UAAU,MAAM,IAAI,GACrC,UAAU,IAAI;AAElB"}

package/dist/esm/reviewDoc/reviewDocProgress.mjs

@@ -0,0 +1,63 @@
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, colorizeNumber, spinnerFrames } from "@intlayer/config/logger";
+
+//#region src/reviewDoc/reviewDocProgress.ts
+/** Refresh rate of the spinner, in milliseconds. */
+const SPINNER_INTERVAL_MS = 100;
+/**
+* Single-line progress indicator used while the documents are compared with
+* their translations.
+*
+* The line is rewritten in place on an interactive terminal, then erased so the
+* final synthesis is printed on a clean line. On a non-interactive output (a
+* file, a CI log) a single static line is printed instead of the animation, to
+* avoid flooding the log with escape sequences.
+*
+* @param totalCount - Number of document/locale pairs to process.
+* @returns The progress logger handles.
+*/
+const createReviewProgressLogger = (totalCount) => {
+	const isInteractive = Boolean(process.stdout.isTTY);
+	let spinnerTimer = null;
+	let spinnerIndex = 0;
+	let processedCount = 0;
+	let isStarted = false;
+	const render = () => {
+		const frame = spinnerFrames[spinnerIndex] ?? "";
+		process.stdout.write(`\r\x1b[2K${colorize(frame, ANSIColors.BLUE)} Processing ${colorizeNumber(processedCount)}/${colorizeNumber(totalCount)}…`);
+	};
+	const start = () => {
+		isStarted = true;
+		if (!isInteractive) {
+			process.stdout.write(`Processing ${colorizeNumber(totalCount)} document/locale pair(s)…\n`);
+			return;
+		}
+		if (spinnerTimer) return;
+		render();
+		spinnerTimer = setInterval(() => {
+			spinnerIndex = (spinnerIndex + 1) % spinnerFrames.length;
+			render();
+		}, SPINNER_INTERVAL_MS);
+	};
+	const increment = () => {
+		processedCount += 1;
+		if (isStarted && isInteractive) render();
+	};
+	const stop = () => {
+		if (spinnerTimer) {
+			clearInterval(spinnerTimer);
+			spinnerTimer = null;
+		}
+		if (isStarted && isInteractive) process.stdout.write("\r\x1B[2K");
+		isStarted = false;
+	};
+	return {
+		start,
+		increment,
+		stop
+	};
+};
+
+//#endregion
+export { createReviewProgressLogger };
+//# sourceMappingURL=reviewDocProgress.mjs.map

package/dist/esm/reviewDoc/reviewDocProgress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDocProgress.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocProgress.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeNumber,\n  spinnerFrames,\n} from '@intlayer/config/logger';\n\n/** Refresh rate of the spinner, in milliseconds. */\nconst SPINNER_INTERVAL_MS = 100;\n\nexport type ReviewProgressLogger = {\n  /** Show the progress line and start animating the spinner. */\n  start: () => void;\n  /** Count one processed document/locale pair and refresh the progress line. */\n  increment: () => void;\n  /** Stop the spinner and erase the progress line. */\n  stop: () => void;\n};\n\n/**\n * Single-line progress indicator used while the documents are compared with\n * their translations.\n *\n * The line is rewritten in place on an interactive terminal, then erased so the\n * final synthesis is printed on a clean line. On a non-interactive output (a\n * file, a CI log) a single static line is printed instead of the animation, to\n * avoid flooding the log with escape sequences.\n *\n * @param totalCount - Number of document/locale pairs to process.\n * @returns The progress logger handles.\n */\nexport const createReviewProgressLogger = (\n  totalCount: number\n): ReviewProgressLogger => {\n  const isInteractive = Boolean(process.stdout.isTTY);\n\n  let spinnerTimer: NodeJS.Timeout | null = null;\n  let spinnerIndex = 0;\n  let processedCount = 0;\n  // Until `start` is called the logger stays silent, so the caller can create it\n  // unconditionally and only display it when relevant.\n  let isStarted = false;\n\n  const render = (): void => {\n    const frame = spinnerFrames[spinnerIndex] ?? '';\n\n    process.stdout.write(\n      `\\r\\x1b[2K${colorize(frame, ANSIColors.BLUE)} Processing ${colorizeNumber(processedCount)}/${colorizeNumber(totalCount)}…`\n    );\n  };\n\n  const start = (): void => {\n    isStarted = true;\n\n    if (!isInteractive) {\n      process.stdout.write(\n        `Processing ${colorizeNumber(totalCount)} document/locale pair(s)…\\n`\n      );\n      return;\n    }\n\n    if (spinnerTimer) return;\n\n    render();\n\n    spinnerTimer = setInterval(() => {\n      spinnerIndex = (spinnerIndex + 1) % spinnerFrames.length;\n      render();\n    }, SPINNER_INTERVAL_MS);\n  };\n\n  const increment = (): void => {\n    processedCount += 1;\n\n    if (isStarted && isInteractive) render();\n  };\n\n  const stop = (): void => {\n    if (spinnerTimer) {\n      clearInterval(spinnerTimer);\n      spinnerTimer = null;\n    }\n\n    if (isStarted && isInteractive) process.stdout.write('\\r\\x1b[2K');\n\n    isStarted = false;\n  };\n\n  return { start, increment, stop };\n};\n"],"mappings":";;;;;AAQA,MAAM,sBAAsB;;;;;;;;;;;;;AAuB5B,MAAa,8BACX,eACyB;CACzB,MAAM,gBAAgB,QAAQ,QAAQ,OAAO,KAAK;CAElD,IAAI,eAAsC;CAC1C,IAAI,eAAe;CACnB,IAAI,iBAAiB;CAGrB,IAAI,YAAY;CAEhB,MAAM,eAAqB;EACzB,MAAM,QAAQ,cAAc,iBAAiB;EAE7C,QAAQ,OAAO,MACb,YAAY,SAAS,OAAO,WAAW,IAAI,EAAE,cAAc,eAAe,cAAc,EAAE,GAAG,eAAe,UAAU,EAAE,EAC1H;CACF;CAEA,MAAM,cAAoB;EACxB,YAAY;EAEZ,IAAI,CAAC,eAAe;GAClB,QAAQ,OAAO,MACb,cAAc,eAAe,UAAU,EAAE,4BAC3C;GACA;EACF;EAEA,IAAI,cAAc;EAElB,OAAO;EAEP,eAAe,kBAAkB;GAC/B,gBAAgB,eAAe,KAAK,cAAc;GAClD,OAAO;EACT,GAAG,mBAAmB;CACxB;CAEA,MAAM,kBAAwB;EAC5B,kBAAkB;EAElB,IAAI,aAAa,eAAe,OAAO;CACzC;CAEA,MAAM,aAAmB;EACvB,IAAI,cAAc;GAChB,cAAc,YAAY;GAC1B,eAAe;EACjB;EAEA,IAAI,aAAa,eAAe,QAAQ,OAAO,MAAM,WAAW;EAEhE,YAAY;CACd;CAEA,OAAO;EAAE;EAAO;EAAW;CAAK;AAClC"}

package/dist/esm/reviewDoc/reviewDocSynthesis.mjs

@@ -0,0 +1,77 @@
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, colorizeNumber } from "@intlayer/config/logger";
+import { formatPath } from "@intlayer/engine/utils";
+
+//#region src/reviewDoc/reviewDocSynthesis.ts
+/** Group results by base document path, preserving the first-seen order. */
+const groupResultsByDocPath = (results) => {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const result of results) {
+		const existingResults = grouped.get(result.docPath);
+		if (existingResults) existingResults.push(result);
+		else grouped.set(result.docPath, [result]);
+	}
+	return grouped;
+};
+/** Render the per-action counts of a document, omitting the zeroed ones. */
+const formatBlockCounts = (summary) => {
+	if (!summary) return "";
+	const formattedCounts = [
+		["review", summary.review],
+		["new", summary.insertNew],
+		["delete", summary.delete]
+	].filter(([, count]) => count > 0).map(([label, count]) => `${label}=${colorizeNumber(count)}`);
+	if (formattedCounts.length === 0) return "";
+	return colorize(` (${formattedCounts.join(", ")})`, ANSIColors.GREY);
+};
+/** Render one outcome section: a title line followed by one line per document. */
+const formatSection = (title, icon, color, results, withBlockCounts) => {
+	if (results.length === 0) return [];
+	const lines = [`${colorize(icon, color)} ${colorize(title, color)} (${colorizeNumber(results.length)})`];
+	for (const [docPath, docResults] of groupResultsByDocPath(results)) {
+		lines.push(`   ${formatPath(docPath)}`);
+		if (withBlockCounts) {
+			for (const result of docResults) lines.push(`     ${colorize(result.locale, color)}${formatBlockCounts(result.summary)}`);
+			continue;
+		}
+		const localeCodes = docResults.map((result) => result.locale).join(", ");
+		lines.push(`     ${colorize(localeCodes, color)}`);
+	}
+	return lines;
+};
+/**
+* Render the end-of-run synthesis: which documents are aligned with their base
+* document and which ones still have blocks to edit.
+*
+* @param results - One entry per reviewed base document / target locale pair.
+* @param options - Rendering options.
+* @returns A multi-line string, ready to be logged.
+*/
+const formatReviewSynthesis = (results, options) => {
+	const upToDateResults = results.filter((result) => result.outcome === "upToDate");
+	const toEditResults = results.filter((result) => result.outcome === "toEdit");
+	const skippedResults = results.filter((result) => result.outcome === "skipped");
+	const documentCount = new Set(results.map((result) => result.docPath)).size;
+	return [
+		[
+			colorize("Review synthesis: ", ANSIColors.BEIGE),
+			colorizeNumber(documentCount),
+			colorize(" document(s), ", ANSIColors.BEIGE),
+			colorizeNumber(results.length),
+			colorize(" locale pair(s) — ", ANSIColors.BEIGE),
+			colorizeNumber(upToDateResults.length),
+			colorize(" up to date, ", ANSIColors.BEIGE),
+			colorizeNumber(toEditResults.length),
+			colorize(options?.hasAppliedChanges ? " updated, " : " to edit, ", ANSIColors.BEIGE),
+			colorizeNumber(skippedResults.length),
+			colorize(" skipped.", ANSIColors.BEIGE)
+		].join(""),
+		...formatSection(options?.hasAppliedChanges ? "Updated" : "To edit", "✎", ANSIColors.ORANGE, toEditResults, true),
+		...formatSection("Up to date", "✔", ANSIColors.GREEN, upToDateResults, false),
+		...formatSection("Skipped", "⊘", ANSIColors.YELLOW, skippedResults, false)
+	].join("\n");
+};
+
+//#endregion
+export { formatReviewSynthesis };
+//# sourceMappingURL=reviewDocSynthesis.mjs.map

package/dist/esm/reviewDoc/reviewDocSynthesis.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDocSynthesis.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocSynthesis.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport {\n  type ANSIColorsType,\n  colorize,\n  colorizeNumber,\n} from '@intlayer/config/logger';\nimport type { ReviewReportSummary } from '@intlayer/engine/docReview';\nimport { formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n\n/**\n * The outcome of reviewing one base document against one target locale.\n *\n * - `upToDate`: the translation matches the base document, nothing to do.\n * - `toEdit`: at least one block diverges (to review, to add, or to delete).\n * - `skipped`: the pair was not reviewed (already exists, modification range…).\n */\nexport type ReviewOutcome = 'upToDate' | 'toEdit' | 'skipped';\n\n/** The result of reviewing a single base document / target locale pair. */\nexport type ReviewFileResult = {\n  /** Path of the base document, as matched by the doc pattern. */\n  docPath: string;\n  /** The reviewed target locale. */\n  locale: Locale;\n  /** What the review concluded for this pair. */\n  outcome: ReviewOutcome;\n  /** Per-action block counts, when the document was actually compared. */\n  summary?: ReviewReportSummary;\n};\n\nexport type FormatReviewSynthesisOptions = {\n  /**\n   * When `true`, the diverging blocks were fixed during the run, so the section\n   * is labelled `Updated` instead of `To edit`.\n   */\n  hasAppliedChanges?: boolean;\n};\n\n/** Group results by base document path, preserving the first-seen order. */\nconst groupResultsByDocPath = (\n  results: ReviewFileResult[]\n): Map<string, ReviewFileResult[]> => {\n  const grouped = new Map<string, ReviewFileResult[]>();\n\n  for (const result of results) {\n    const existingResults = grouped.get(result.docPath);\n\n    if (existingResults) existingResults.push(result);\n    else grouped.set(result.docPath, [result]);\n  }\n\n  return grouped;\n};\n\n/** Render the per-action counts of a document, omitting the zeroed ones. */\nconst formatBlockCounts = (summary?: ReviewReportSummary): string => {\n  if (!summary) return '';\n\n  const countEntries: [label: string, count: number][] = [\n    ['review', summary.review],\n    ['new', summary.insertNew],\n    ['delete', summary.delete],\n  ];\n\n  const formattedCounts = countEntries\n    .filter(([, count]) => count > 0)\n    .map(([label, count]) => `${label}=${colorizeNumber(count)}`);\n\n  if (formattedCounts.length === 0) return '';\n\n  return colorize(` (${formattedCounts.join(', ')})`, ANSIColors.GREY);\n};\n\n/** Render one outcome section: a title line followed by one line per document. */\nconst formatSection = (\n  title: string,\n  icon: string,\n  color: ANSIColorsType,\n  results: ReviewFileResult[],\n  withBlockCounts: boolean\n): string[] => {\n  if (results.length === 0) return [];\n\n  const lines: string[] = [\n    `${colorize(icon, color)} ${colorize(title, color)} (${colorizeNumber(results.length)})`,\n  ];\n\n  for (const [docPath, docResults] of groupResultsByDocPath(results)) {\n    lines.push(`   ${formatPath(docPath)}`);\n\n    if (withBlockCounts) {\n      for (const result of docResults) {\n        lines.push(\n          `     ${colorize(result.locale, color)}${formatBlockCounts(result.summary)}`\n        );\n      }\n      continue;\n    }\n\n    const localeCodes = docResults.map((result) => result.locale).join(', ');\n    lines.push(`     ${colorize(localeCodes, color)}`);\n  }\n\n  return lines;\n};\n\n/**\n * Render the end-of-run synthesis: which documents are aligned with their base\n * document and which ones still have blocks to edit.\n *\n * @param results - One entry per reviewed base document / target locale pair.\n * @param options - Rendering options.\n * @returns A multi-line string, ready to be logged.\n */\nexport const formatReviewSynthesis = (\n  results: ReviewFileResult[],\n  options?: FormatReviewSynthesisOptions\n): string => {\n  const upToDateResults = results.filter(\n    (result) => result.outcome === 'upToDate'\n  );\n  const toEditResults = results.filter((result) => result.outcome === 'toEdit');\n  const skippedResults = results.filter(\n    (result) => result.outcome === 'skipped'\n  );\n\n  const documentCount = new Set(results.map((result) => result.docPath)).size;\n\n  const header = [\n    colorize('Review synthesis: ', ANSIColors.BEIGE),\n    colorizeNumber(documentCount),\n    colorize(' document(s), ', ANSIColors.BEIGE),\n    colorizeNumber(results.length),\n    colorize(' locale pair(s) — ', ANSIColors.BEIGE),\n    colorizeNumber(upToDateResults.length),\n    colorize(' up to date, ', ANSIColors.BEIGE),\n    colorizeNumber(toEditResults.length),\n    colorize(\n      options?.hasAppliedChanges ? ' updated, ' : ' to edit, ',\n      ANSIColors.BEIGE\n    ),\n    colorizeNumber(skippedResults.length),\n    colorize(' skipped.', ANSIColors.BEIGE),\n  ].join('');\n\n  return [\n    header,\n    ...formatSection(\n      options?.hasAppliedChanges ? 'Updated' : 'To edit',\n      '✎',\n      ANSIColors.ORANGE,\n      toEditResults,\n      true\n    ),\n    ...formatSection(\n      'Up to date',\n      '✔',\n      ANSIColors.GREEN,\n      upToDateResults,\n      false\n    ),\n    ...formatSection('Skipped', '⊘', ANSIColors.YELLOW, skippedResults, false),\n  ].join('\\n');\n};\n"],"mappings":";;;;;;AAwCA,MAAM,yBACJ,YACoC;CACpC,MAAM,0BAAU,IAAI,IAAgC;CAEpD,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,kBAAkB,QAAQ,IAAI,OAAO,OAAO;EAElD,IAAI,iBAAiB,gBAAgB,KAAK,MAAM;OAC3C,QAAQ,IAAI,OAAO,SAAS,CAAC,MAAM,CAAC;CAC3C;CAEA,OAAO;AACT;;AAGA,MAAM,qBAAqB,YAA0C;CACnE,IAAI,CAAC,SAAS,OAAO;CAQrB,MAAM,kBAAkB;EALtB,CAAC,UAAU,QAAQ,MAAM;EACzB,CAAC,OAAO,QAAQ,SAAS;EACzB,CAAC,UAAU,QAAQ,MAAM;CAGQ,CAAC,CACjC,QAAQ,GAAG,WAAW,QAAQ,CAAC,CAAC,CAChC,KAAK,CAAC,OAAO,WAAW,GAAG,MAAM,GAAG,eAAe,KAAK,GAAG;CAE9D,IAAI,gBAAgB,WAAW,GAAG,OAAO;CAEzC,OAAO,SAAS,KAAK,gBAAgB,KAAK,IAAI,EAAE,IAAI,WAAW,IAAI;AACrE;;AAGA,MAAM,iBACJ,OACA,MACA,OACA,SACA,oBACa;CACb,IAAI,QAAQ,WAAW,GAAG,OAAO,CAAC;CAElC,MAAM,QAAkB,CACtB,GAAG,SAAS,MAAM,KAAK,EAAE,GAAG,SAAS,OAAO,KAAK,EAAE,IAAI,eAAe,QAAQ,MAAM,EAAE,EACxF;CAEA,KAAK,MAAM,CAAC,SAAS,eAAe,sBAAsB,OAAO,GAAG;EAClE,MAAM,KAAK,MAAM,WAAW,OAAO,GAAG;EAEtC,IAAI,iBAAiB;GACnB,KAAK,MAAM,UAAU,YACnB,MAAM,KACJ,QAAQ,SAAS,OAAO,QAAQ,KAAK,IAAI,kBAAkB,OAAO,OAAO,GAC3E;GAEF;EACF;EAEA,MAAM,cAAc,WAAW,KAAK,WAAW,OAAO,MAAM,CAAC,CAAC,KAAK,IAAI;EACvE,MAAM,KAAK,QAAQ,SAAS,aAAa,KAAK,GAAG;CACnD;CAEA,OAAO;AACT;;;;;;;;;AAUA,MAAa,yBACX,SACA,YACW;CACX,MAAM,kBAAkB,QAAQ,QAC7B,WAAW,OAAO,YAAY,UACjC;CACA,MAAM,gBAAgB,QAAQ,QAAQ,WAAW,OAAO,YAAY,QAAQ;CAC5E,MAAM,iBAAiB,QAAQ,QAC5B,WAAW,OAAO,YAAY,SACjC;CAEA,MAAM,gBAAgB,IAAI,IAAI,QAAQ,KAAK,WAAW,OAAO,OAAO,CAAC,CAAC,CAAC;CAmBvE,OAAO;EAjBQ;GACb,SAAS,sBAAsB,WAAW,KAAK;GAC/C,eAAe,aAAa;GAC5B,SAAS,kBAAkB,WAAW,KAAK;GAC3C,eAAe,QAAQ,MAAM;GAC7B,SAAS,sBAAsB,WAAW,KAAK;GAC/C,eAAe,gBAAgB,MAAM;GACrC,SAAS,iBAAiB,WAAW,KAAK;GAC1C,eAAe,cAAc,MAAM;GACnC,SACE,SAAS,oBAAoB,eAAe,cAC5C,WAAW,KACb;GACA,eAAe,eAAe,MAAM;GACpC,SAAS,aAAa,WAAW,KAAK;EACxC,CAAC,CAAC,KAAK,EAGA;EACL,GAAG,cACD,SAAS,oBAAoB,YAAY,WACzC,KACA,WAAW,QACX,eACA,IACF;EACA,GAAG,cACD,cACA,KACA,WAAW,OACX,iBACA,KACF;EACA,GAAG,cAAc,WAAW,KAAK,WAAW,QAAQ,gBAAgB,KAAK;CAC3E,CAAC,CAAC,KAAK,IAAI;AACb"}

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ import { liveSync } from "./liveSync.js";
 import { pull } from "./pull.js";
 import { push } from "./push/push.js";
 import { pushConfig } from "./pushConfig.js";
-import { reviewDoc } from "./reviewDoc/reviewDoc.js";
+import { ReviewDocMode, reviewDoc } from "./reviewDoc/reviewDoc.js";
 import { ScanCommandOptions, scan } from "./scan.js";
 import { searchDoc } from "./searchDoc.js";
 import { listMissingTranslations, listMissingTranslationsWithConfig } from "./test/listMissingTranslations.js";
@@ -23,4 +23,4 @@ export type * from "@intlayer/engine/cli";
 export type * from "@intlayer/engine/build";
 export type * from "@intlayer/engine/utils";
 export type * from "@intlayer/engine/watcher";
-export { ConfigurationOptions, FillOptions, ListProjectsCommandOptions, PLATFORM_OPTIONS, ScanCommandOptions, build, bundle, dirname, extract, fill, findProjectRoot, getDetectedPlatform, init, initSkills, listContentDeclaration, listContentDeclarationRows, listMissingTranslations, listMissingTranslationsWithConfig, listProjectsCommand, liveSync, pull, push, pushConfig, reviewDoc, scan, searchDoc, setAPI, startEditor, testMissingTranslations, translateDoc };
+export { ConfigurationOptions, FillOptions, ListProjectsCommandOptions, PLATFORM_OPTIONS, ReviewDocMode, ScanCommandOptions, build, bundle, dirname, extract, fill, findProjectRoot, getDetectedPlatform, init, initSkills, listContentDeclaration, listContentDeclarationRows, listMissingTranslations, listMissingTranslationsWithConfig, listProjectsCommand, liveSync, pull, push, pushConfig, reviewDoc, scan, searchDoc, setAPI, startEditor, testMissingTranslations, translateDoc };

package/dist/types/reviewDoc/reviewDoc.d.ts

@@ -1,8 +1,19 @@
+import { ReviewFileResult } from "./reviewDocSynthesis.js";
 import { GetConfigurationOptions } from "@intlayer/config/node";
 import { AIOptions } from "@intlayer/api";
 import { ListGitFilesOptions } from "@intlayer/engine/cli";
 import { Locale } from "@intlayer/types/allLocales";
 //#region src/reviewDoc/reviewDoc.d.ts
+/**
+ * How the review should be run.
+ *
+ * - `apply`: translate the diverging blocks with AI and write the target files.
+ * - `report`: no AI. Log every block that needs attention (line numbers and
+ *   content, for both locales) so another agent can generate the translations.
+ * - `synthesis`: no AI, no per-block output. Only log the final synthesis of the
+ *   documents that are up to date and the ones that still have blocks to edit.
+ */
+type ReviewDocMode = 'apply' | 'report' | 'synthesis';
 type ReviewDocOptions = {
   docPattern: string[];
   locales: Locale[];
@@ -16,18 +27,14 @@ type ReviewDocOptions = {
   skipIfModifiedAfter?: number | string | Date;
   skipIfExists?: boolean;
   gitOptions?: ListGitFilesOptions;
-  /**
-   * Log-only mode. Instead of translating the changed blocks with AI, log the
-   * blocks that need attention (with line numbers and content) for the base and
-   * target locales, so another agent can generate the translations.
-   */
-  log?: boolean;
+  /** How the review should be run. Defaults to `apply`. See {@link ReviewDocMode}. */
+  mode?: ReviewDocMode;
 };
 /**
  * Main audit function: scans all .md files in "en/" (unless you specified DOC_LIST),
  * then audits them to each locale in LOCALE_LIST.
  */
-declare const reviewDoc: ({ docPattern, locales, excludedGlobPattern, baseLocale, aiOptions, nbSimultaneousFileProcessed, configOptions, customInstructions, skipIfModifiedBefore, skipIfModifiedAfter, skipIfExists, gitOptions, log }: ReviewDocOptions) => Promise<void>;
+declare const reviewDoc: ({ docPattern, locales, excludedGlobPattern, baseLocale, aiOptions, nbSimultaneousFileProcessed, configOptions, customInstructions, skipIfModifiedBefore, skipIfModifiedAfter, skipIfExists, gitOptions, mode }: ReviewDocOptions) => Promise<ReviewFileResult[]>;
 //#endregion
-export { reviewDoc };
+export { ReviewDocMode, reviewDoc };
 //# sourceMappingURL=reviewDoc.d.ts.map

package/dist/types/reviewDoc/reviewDoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDoc.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"mappings":";;;;;KAiCK;EACH;EACA,SAAS;EACT;EACA,YAAY;EACZ,YAAY;EACZ;EACA,gBAAgB;EAChB;EACA,yCAAyC;EACzC,wCAAwC;EACxC;EACA,aAAa;;;;;;EAMb;;;;;;cAOW,cAAS,YAAA,SAAA,qBAAA,YAAA,WAAA,6BAAA,eAAA,oBAAA,sBAAA,qBAAA,cAAA,YAAA,OAcnB,qBAAgB"}
+{"version":3,"file":"reviewDoc.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"mappings":";;;;;;;;;;;;;;;KAmDY;KAEP;EACH;EACA,SAAS;EACT;EACA,YAAY;EACZ,YAAY;EACZ;EACA,gBAAgB;EAChB;EACA,yCAAyC;EACzC,wCAAwC;EACxC;EACA,aAAa;;EAEb,OAAO;;;;;;cAOI,cAAS,YAAA,SAAA,qBAAA,YAAA,WAAA,6BAAA,eAAA,oBAAA,sBAAA,qBAAA,cAAA,YAAA,QAcnB,qBAAgB,QAAA"}