@intlayer/cli 9.0.0-canary.0 → 9.0.0-canary.1

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs

@@ -1,7 +1,5 @@
 import { readAsset } from "../_virtual/_utils_asset.mjs";
 import { sanitizeChunk, validateTranslation } from "../translateDoc/validation.mjs";
-import { mergeReviewedSegments } from "../translation-alignment/rebuildDocument.mjs";
-import { buildAlignmentPlan } from "../translation-alignment/pipeline.mjs";
 import { chunkInference } from "../utils/chunkInference.mjs";
 import { fixChunkStartEndChars } from "../utils/fixChunkStartEndChars.mjs";
 import { mkdirSync, writeFileSync } from "node:fs";
@@ -12,48 +10,69 @@ import { colon, colorize, colorizeNumber, getAppLogger } from "@intlayer/config/
 import { getConfiguration } from "@intlayer/config/node";
 import { retryManager } from "@intlayer/config/utils";
 import { readFile } from "node:fs/promises";
+import { buildAlignmentPlan, mergeReviewedSegments } from "@intlayer/chokidar/docReview";
 import { getLocaleName } from "@intlayer/core/localization";
 import { ENGLISH } from "@intlayer/types/locales";
 
 //#region src/reviewDoc/reviewDocBlockAware.ts
 /**
 * Review a file using block-aware alignment.
-* This approach:
-* 1. Segments both English and French documents into semantic blocks
-* 2. Aligns blocks using structure (special chars, numbers) and context
-* 3. Detects which blocks changed, were added, or deleted
-* 4. Only sends changed/new blocks to AI for translation
-* 5. Handles reordering automatically
+*
+* 1. Segments both base and target documents into semantic blocks.
+* 2. Aligns blocks using structure (special chars, numbers) and context.
+* 3. Detects which blocks changed, were added, or deleted.
+* 4. Applies deletions immediately without AI.
+* 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.
 */
 const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLocale, aiOptions, configOptions, customInstructions, changedLines, aiClient, aiConfig) => {
 	const configuration = getConfiguration(configOptions);
-	const applicationLogger = getAppLogger(configuration);
-	const englishText = await readFile(baseFilePath, "utf-8");
-	const frenchText = await readFile(outputFilePath, "utf-8").catch(() => "");
+	const applicationLogger = getAppLogger({ log: {
+		...configuration.log,
+		prefix: ""
+	} });
+	const baseText = await readFile(baseFilePath, "utf-8");
+	const targetText = await readFile(outputFilePath, "utf-8").catch(() => "");
 	const basePrompt = readAsset("./prompts/REVIEW_PROMPT.md", "utf-8").replaceAll("{{localeName}}", `${formatLocale(locale, false)}`).replaceAll("{{baseLocaleName}}", `${formatLocale(baseLocale, false)}`).replace("{{applicationContext}}", aiOptions?.applicationContext ?? "-").replace("{{customInstructions}}", customInstructions ?? "-");
 	const filePrefix = [colon(`${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `, { colSize: 40 }), `→ ${ANSIColors.RESET}`].join("");
 	const prefix = [colon(`${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `, { colSize: 40 }), `→ ${ANSIColors.RESET}`].join("");
-	const { englishBlocks, frenchBlocks, plan, segmentsToReview } = buildAlignmentPlan({
-		englishText,
-		frenchText,
+	const { baseBlocks, targetBlocks, plan, segmentsToReview } = buildAlignmentPlan({
+		baseText,
+		targetText,
 		changedLines
 	});
-	applicationLogger(`${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.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(plan.actions.filter((a) => a.kind === "delete").length)}`);
-	if (segmentsToReview.length === 0) {
-		applicationLogger(`${filePrefix}No segments need review, reusing existing translation`);
+	const deleteCount = plan.actions.filter((a) => a.kind === "delete").length;
+	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)}`);
+	const reviewedSegmentsMap = /* @__PURE__ */ new Map();
+	for (const [actionIndex, action] of plan.actions.entries()) if (action.kind === "delete") reviewedSegmentsMap.set(actionIndex, "");
+	const writeCurrentState = () => {
+		const output = mergeReviewedSegments(plan, targetBlocks, reviewedSegmentsMap);
 		mkdirSync(dirname(outputFilePath), { recursive: true });
-		writeFileSync(outputFilePath, mergeReviewedSegments(plan, frenchBlocks, /* @__PURE__ */ new Map()));
-		applicationLogger(`${colorize("✔", ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`);
+		writeFileSync(outputFilePath, output);
+	};
+	if (deleteCount > 0) {
+		writeCurrentState();
+		applicationLogger(`${filePrefix}${colorizeNumber(deleteCount)} block(s) deleted without AI.`);
+	}
+	if (segmentsToReview.length === 0) {
+		if (deleteCount === 0) {
+			applicationLogger(`${filePrefix}No segments need review, reusing existing translation`);
+			writeCurrentState();
+		}
+		applicationLogger(`${colorize("✔", ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no AI changes needed).`);
 		return;
 	}
-	applicationLogger(`${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`);
-	const reviewedSegmentsMap = /* @__PURE__ */ new Map();
-	for (const segment of segmentsToReview) {
-		const segmentNumber = segmentsToReview.indexOf(segment) + 1;
-		const englishBlock = segment.englishBlock;
-		const getBaseChunkContextPrompt = () => `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\n///chunksStart///\n` + englishBlock.content + `///chunksEnd///`;
-		const getFrenchChunkPrompt = () => `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\n///chunksStart///\n` + (segment.frenchBlockText ?? "") + `///chunksEnd///`;
+	applicationLogger(`${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`);
+	const segmentsBottomUp = segmentsToReview.map((segment, originalIndex) => ({
+		segment,
+		displayNumber: originalIndex + 1
+	})).reverse();
+	for (const { segment, displayNumber } of segmentsBottomUp) {
+		const baseBlock = segment.baseBlock;
+		const getBaseChunkContextPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\n///chunksStart///\n` + baseBlock.content + `///chunksEnd///`;
+		const getTargetChunkPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\n///chunksStart///\n` + (segment.targetBlockText ?? "") + `///chunksEnd///`;
 		const reviewedChunkResult = await retryManager(async () => {
 			const result = await chunkInference([
 				{
@@ -66,27 +85,25 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 				},
 				{
 					role: "system",
-					content: getFrenchChunkPrompt()
+					content: getTargetChunkPrompt()
 				},
 				{
 					role: "system",
-					content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`
+					content: `The next user message will be the **BLOCK ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`
 				}
 			], [{
 				role: "user",
-				content: englishBlock.content
+				content: baseBlock.content
 			}], aiOptions, configuration, aiClient, aiConfig);
-			applicationLogger(`${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`);
-			let processedChunk = sanitizeChunk(result?.fileContent, englishBlock.content);
-			processedChunk = fixChunkStartEndChars(processedChunk, englishBlock.content);
-			if (!validateTranslation(englishBlock.content, processedChunk, applicationLogger)) throw new Error("Validation failed for chunk (structure or length mismatch). Retrying...");
+			applicationLogger(`${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}`);
+			let processedChunk = sanitizeChunk(result?.fileContent, baseBlock.content);
+			processedChunk = fixChunkStartEndChars(processedChunk, baseBlock.content);
+			if (!validateTranslation(baseBlock.content, processedChunk, applicationLogger)) throw new Error("Validation failed for chunk (structure or length mismatch). Retrying...");
 			return processedChunk;
 		})();
 		reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);
+		writeCurrentState();
 	}
-	const finalFrenchOutput = mergeReviewedSegments(plan, frenchBlocks, reviewedSegmentsMap);
-	mkdirSync(dirname(outputFilePath), { recursive: true });
-	writeFileSync(outputFilePath, finalFrenchOutput);
 	applicationLogger(`${colorize("✔", ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`);
 };
 

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 { formatLocale, formatPath } from '@intlayer/chokidar/utils';\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 type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '../translation-alignment/pipeline';\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 * This approach:\n * 1. Segments both English and French 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. Only sends changed/new blocks to AI for translation\n * 5. Handles reordering automatically\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(configuration);\n\n  const englishText = await readFile(baseFilePath, 'utf-8');\n  const frenchText = 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 { englishBlocks, frenchBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      englishText,\n      frenchText,\n      changedLines,\n    });\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.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(plan.actions.filter((a) => a.kind === 'delete').length)}`\n  );\n\n  if (segmentsToReview.length === 0) {\n    applicationLogger(\n      `${filePrefix}No segments need review, reusing existing translation`\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(\n      outputFilePath,\n      mergeReviewedSegments(plan, frenchBlocks, new Map())\n    );\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`\n  );\n\n  // Review segments that need AI translation\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  for (const segment of segmentsToReview) {\n    const segmentNumber = segmentsToReview.indexOf(segment) + 1;\n    const englishBlock = segment.englishBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      englishBlock.content +\n      `///chunksEnd///`;\n\n    const getFrenchChunkPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.frenchBlockText ?? '') +\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: getFrenchChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: englishBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      // Sanitize artifacts (e.g. Markdown code block wrappers)\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        englishBlock.content\n      );\n\n      // Fix start/end characters\n      processedChunk = fixChunkStartEndChars(\n        processedChunk,\n        englishBlock.content\n      );\n\n      // Validate Translation (YAML, Code fences, Length ratio)\n      const isValid = validateTranslation(\n        englishBlock.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\n  // Merge reviewed segments back into final document\n  const finalFrenchOutput = mergeReviewedSegments(\n    plan,\n    frenchBlocks,\n    reviewedSegmentsMap\n  );\n\n  mkdirSync(dirname(outputFilePath), { recursive: true });\n  writeFileSync(outputFilePath, finalFrenchOutput);\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":"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"}
+{"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 {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '@intlayer/chokidar/docReview';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\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 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":"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"}

package/dist/esm/reviewDoc/reviewDocLog.mjs

@@ -0,0 +1,46 @@
+import { existsSync } from "node:fs";
+import { formatLocale, formatPath } from "@intlayer/chokidar/utils";
+import { getAppLogger } from "@intlayer/config/logger";
+import { getConfiguration } from "@intlayer/config/node";
+import { readFile } from "node:fs/promises";
+import { buildReviewReport, formatReviewReport } from "@intlayer/chokidar/docReview";
+
+//#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.
+*
+* @param baseFilePath - Absolute path of the base (source) document.
+* @param outputFilePath - Absolute path of the target (translated) 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 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 };
+//# sourceMappingURL=reviewDocLog.mjs.map

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

@@ -0,0 +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 {\n  buildReviewReport,\n  formatReviewReport,\n  type ReviewReport,\n} from '@intlayer/chokidar/docReview';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\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,cACiB,CAAC;EAAK,QAAQ;EAAI,EAAE,CAAC;CAO7E,MAAM,SAAS,kBAAkB;EAAE,gBALZ,SAAS,cAAc,QAAQ;EAKT,YAJ1B,WAAW,eAAe,GACzC,MAAM,SAAS,gBAAgB,QAAQ,CAAC,YAAY,GAAG,GACvD;EAEqD;EAAc,CAAC;CAExE,MAAM,YAAY,mBAAmB,QAAQ;EAC3C,WAAW,aAAa,WAAW;EACnC,aAAa,aAAa,OAAO;EAClC,CAAC;AAEF,WAAU,GAAG,WAAW,aAAa,CAAC,KAAK,aAAa,OAAO,GAAG;AAClE,MAAK,MAAM,QAAQ,UAAU,MAAM,KAAK,CACtC,WAAU,KAAK;AAGjB,QAAO"}

package/dist/esm/utils/formatLineRanges.mjs

@@ -0,0 +1,42 @@
+//#region src/utils/formatLineRanges.ts
+/**
+* Formats a list of line numbers into a compact, human-readable string where
+* runs of consecutive lines are collapsed into ranges.
+*
+* The input is sorted and de-duplicated first, so callers don't need to
+* pre-process it. A run of a single line is printed as the bare number; a run
+* of two or more consecutive lines is printed as `start-end`.
+*
+* @example
+* formatLineRanges([2, 3, 4, 5, 333, 412, 413, 414]);
+* // → '2-5, 333, 412-414'
+*
+* @param lineNumbers - The (possibly unsorted, possibly duplicated) line numbers.
+* @param separator - String inserted between groups. Defaults to `', '`.
+* @returns The grouped string, or an empty string when no lines are provided.
+*/
+const formatLineRanges = (lineNumbers, separator = ", ") => {
+	const sortedUniqueLines = [...new Set(lineNumbers)].sort((a, b) => a - b);
+	if (sortedUniqueLines.length === 0) return "";
+	const groups = [];
+	let rangeStart = sortedUniqueLines[0];
+	let rangeEnd = rangeStart;
+	const pushGroup = () => {
+		groups.push(rangeStart === rangeEnd ? `${rangeStart}` : `${rangeStart}-${rangeEnd}`);
+	};
+	for (const lineNumber of sortedUniqueLines.slice(1)) {
+		if (lineNumber === rangeEnd + 1) {
+			rangeEnd = lineNumber;
+			continue;
+		}
+		pushGroup();
+		rangeStart = lineNumber;
+		rangeEnd = lineNumber;
+	}
+	pushGroup();
+	return groups.join(separator);
+};
+
+//#endregion
+export { formatLineRanges };
+//# sourceMappingURL=formatLineRanges.mjs.map

package/dist/esm/utils/formatLineRanges.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatLineRanges.mjs","names":[],"sources":["../../../src/utils/formatLineRanges.ts"],"sourcesContent":["/**\n * Formats a list of line numbers into a compact, human-readable string where\n * runs of consecutive lines are collapsed into ranges.\n *\n * The input is sorted and de-duplicated first, so callers don't need to\n * pre-process it. A run of a single line is printed as the bare number; a run\n * of two or more consecutive lines is printed as `start-end`.\n *\n * @example\n * formatLineRanges([2, 3, 4, 5, 333, 412, 413, 414]);\n * // → '2-5, 333, 412-414'\n *\n * @param lineNumbers - The (possibly unsorted, possibly duplicated) line numbers.\n * @param separator - String inserted between groups. Defaults to `', '`.\n * @returns The grouped string, or an empty string when no lines are provided.\n */\nexport const formatLineRanges = (\n  lineNumbers: number[],\n  separator = ', '\n): string => {\n  const sortedUniqueLines = [...new Set(lineNumbers)].sort((a, b) => a - b);\n\n  if (sortedUniqueLines.length === 0) return '';\n\n  const groups: string[] = [];\n  let rangeStart = sortedUniqueLines[0]!;\n  let rangeEnd = rangeStart;\n\n  const pushGroup = (): void => {\n    groups.push(\n      rangeStart === rangeEnd ? `${rangeStart}` : `${rangeStart}-${rangeEnd}`\n    );\n  };\n\n  for (const lineNumber of sortedUniqueLines.slice(1)) {\n    if (lineNumber === rangeEnd + 1) {\n      // Still inside the current consecutive run.\n      rangeEnd = lineNumber;\n      continue;\n    }\n\n    // Gap detected: close the current run and start a new one.\n    pushGroup();\n    rangeStart = lineNumber;\n    rangeEnd = lineNumber;\n  }\n\n  pushGroup();\n\n  return groups.join(separator);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,MAAa,oBACX,aACA,YAAY,SACD;CACX,MAAM,oBAAoB,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE;AAEzE,KAAI,kBAAkB,WAAW,EAAG,QAAO;CAE3C,MAAM,SAAmB,EAAE;CAC3B,IAAI,aAAa,kBAAkB;CACnC,IAAI,WAAW;CAEf,MAAM,kBAAwB;AAC5B,SAAO,KACL,eAAe,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,WAC9D;;AAGH,MAAK,MAAM,cAAc,kBAAkB,MAAM,EAAE,EAAE;AACnD,MAAI,eAAe,WAAW,GAAG;AAE/B,cAAW;AACX;;AAIF,aAAW;AACX,eAAa;AACb,aAAW;;AAGb,YAAW;AAEX,QAAO,OAAO,KAAK,UAAU"}

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

@@ -17,6 +17,12 @@ 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;
 };
 /**
  * Main audit function: scans all .md files in "en/" (unless you specified DOC_LIST),
@@ -34,7 +40,8 @@ declare const reviewDoc: ({
   skipIfModifiedBefore,
   skipIfModifiedAfter,
   skipIfExists,
-  gitOptions
+  gitOptions,
+  log
 }: ReviewDocOptions) => Promise<void>;
 //#endregion
 export { reviewDoc };

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

@@ -1 +1 @@
-{"version":3,"file":"reviewDoc.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"mappings":";;;;;;KAgCK,gBAAA;EACH,UAAA;EACA,OAAA,EAAS,MAAA;EACT,mBAAA;EACA,UAAA,EAAY,MAAA;EACZ,SAAA,GAAY,SAAA;EACZ,2BAAA;EACA,aAAA,GAAgB,uBAAA;EAChB,kBAAA;EACA,oBAAA,qBAAyC,IAAA;EACzC,mBAAA,qBAAwC,IAAA;EACxC,YAAA;EACA,UAAA,GAAa,mBAAA;AAAA;;;;;cAOF,SAAA;EAAmB,UAAA;EAAA,OAAA;EAAA,mBAAA;EAAA,UAAA;EAAA,SAAA;EAAA,2BAAA;EAAA,aAAA;EAAA,kBAAA;EAAA,oBAAA;EAAA,mBAAA;EAAA,YAAA;EAAA;AAAA,GAa7B,gBAAA,KAAgB,OAAA"}
+{"version":3,"file":"reviewDoc.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"mappings":";;;;;;KAqCK,gBAAA;EACH,UAAA;EACA,OAAA,EAAS,MAAA;EACT,mBAAA;EACA,UAAA,EAAY,MAAA;EACZ,SAAA,GAAY,SAAA;EACZ,2BAAA;EACA,aAAA,GAAgB,uBAAA;EAChB,kBAAA;EACA,oBAAA,qBAAyC,IAAA;EACzC,mBAAA,qBAAwC,IAAA;EACxC,YAAA;EACA,UAAA,GAAa,mBAAA;EAAmB;;;;;EAMhC,GAAA;AAAA;;;;;cAOW,SAAA;EAAmB,UAAA;EAAA,OAAA;EAAA,mBAAA;EAAA,UAAA;EAAA,SAAA;EAAA,2BAAA;EAAA,aAAA;EAAA,kBAAA;EAAA,oBAAA;EAAA,mBAAA;EAAA,YAAA;EAAA,UAAA;EAAA;AAAA,GAc7B,gBAAA,KAAgB,OAAA"}

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

@@ -7,12 +7,14 @@ import { AIConfig } from "@intlayer/ai";
 //#region src/reviewDoc/reviewDocBlockAware.d.ts
 /**
  * Review a file using block-aware alignment.
- * This approach:
- * 1. Segments both English and French documents into semantic blocks
- * 2. Aligns blocks using structure (special chars, numbers) and context
- * 3. Detects which blocks changed, were added, or deleted
- * 4. Only sends changed/new blocks to AI for translation
- * 5. Handles reordering automatically
+ *
+ * 1. Segments both base and target documents into semantic blocks.
+ * 2. Aligns blocks using structure (special chars, numbers) and context.
+ * 3. Detects which blocks changed, were added, or deleted.
+ * 4. Applies deletions immediately without AI.
+ * 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.
  */
 declare const reviewFileBlockAware: (baseFilePath: string, outputFilePath: string, locale: Locale, baseLocale: Locale, aiOptions?: AIOptions, configOptions?: GetConfigurationOptions, customInstructions?: string, changedLines?: number[], aiClient?: AIClient, aiConfig?: AIConfig) => Promise<void>;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"reviewDocBlockAware.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"mappings":";;;;;;;;;AAwCA;;;;;;;cAAa,oBAAA,GACX,YAAA,UACA,cAAA,UACA,MAAA,EAAQ,MAAA,EACR,UAAA,EAAY,MAAA,EACZ,SAAA,GAAY,SAAA,EACZ,aAAA,GAAgB,uBAAA,EAChB,kBAAA,WACA,YAAA,aACA,QAAA,GAAW,QAAA,EACX,QAAA,GAAW,QAAA,KAAQ,OAAA"}
+{"version":3,"file":"reviewDocBlockAware.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"mappings":";;;;;;;;;AA0CA;;;;;;;;;cAAa,oBAAA,GACX,YAAA,UACA,cAAA,UACA,MAAA,EAAQ,MAAA,EACR,UAAA,EAAY,MAAA,EACZ,SAAA,GAAY,SAAA,EACZ,aAAA,GAAgB,uBAAA,EAChB,kBAAA,WACA,YAAA,aACA,QAAA,GAAW,QAAA,EACX,QAAA,GAAW,QAAA,KAAQ,OAAA"}

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

@@ -0,0 +1,25 @@
+import { GetConfigurationOptions } from "@intlayer/config/node";
+import { Locale } from "@intlayer/types/allLocales";
+import { ReviewReport } from "@intlayer/chokidar/docReview";
+
+//#region src/reviewDoc/reviewDocLog.d.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.
+ *
+ * @param baseFilePath - Absolute path of the base (source) document.
+ * @param outputFilePath - Absolute path of the target (translated) 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.
+ */
+declare const logReviewFileBlocks: (baseFilePath: string, outputFilePath: string, locale: Locale, baseLocale: Locale, configOptions?: GetConfigurationOptions, changedLines?: number[]) => Promise<ReviewReport>;
+//#endregion
+export { logReviewFileBlocks };
+//# sourceMappingURL=reviewDocLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDocLog.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocLog.ts"],"mappings":";;;;;;;AA+BA;;;;;;;;;;;;;;cAAa,mBAAA,GACX,YAAA,UACA,cAAA,UACA,MAAA,EAAQ,MAAA,EACR,UAAA,EAAY,MAAA,EACZ,aAAA,GAAgB,uBAAA,EAChB,YAAA,gBACC,OAAA,CAAQ,YAAA"}

package/dist/types/utils/formatLineRanges.d.ts

@@ -0,0 +1,21 @@
+//#region src/utils/formatLineRanges.d.ts
+/**
+ * Formats a list of line numbers into a compact, human-readable string where
+ * runs of consecutive lines are collapsed into ranges.
+ *
+ * The input is sorted and de-duplicated first, so callers don't need to
+ * pre-process it. A run of a single line is printed as the bare number; a run
+ * of two or more consecutive lines is printed as `start-end`.
+ *
+ * @example
+ * formatLineRanges([2, 3, 4, 5, 333, 412, 413, 414]);
+ * // → '2-5, 333, 412-414'
+ *
+ * @param lineNumbers - The (possibly unsorted, possibly duplicated) line numbers.
+ * @param separator - String inserted between groups. Defaults to `', '`.
+ * @returns The grouped string, or an empty string when no lines are provided.
+ */
+declare const formatLineRanges: (lineNumbers: number[], separator?: string) => string;
+//#endregion
+export { formatLineRanges };
+//# sourceMappingURL=formatLineRanges.d.ts.map

package/dist/types/utils/formatLineRanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatLineRanges.d.ts","names":[],"sources":["../../../src/utils/formatLineRanges.ts"],"mappings":";;AAgBA;;;;;;;;;;;;;;;cAAa,gBAAA,GACX,WAAA,YACA,SAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/cli",
-  "version": "9.0.0-canary.0",
+  "version": "9.0.0-canary.1",
   "private": false,
   "description": "Provides uniform command-line interface scripts for Intlayer, used in packages like intlayer-cli and intlayer.",
   "keywords": [
@@ -67,22 +67,22 @@
   },
   "dependencies": {
     "@clack/prompts": "0.11.0",
-    "@intlayer/api": "9.0.0-canary.0",
-    "@intlayer/babel": "9.0.0-canary.0",
-    "@intlayer/chokidar": "9.0.0-canary.0",
-    "@intlayer/config": "9.0.0-canary.0",
-    "@intlayer/core": "9.0.0-canary.0",
-    "@intlayer/dictionaries-entry": "9.0.0-canary.0",
-    "@intlayer/remote-dictionaries-entry": "9.0.0-canary.0",
-    "@intlayer/types": "9.0.0-canary.0",
-    "@intlayer/unmerged-dictionaries-entry": "9.0.0-canary.0",
+    "@intlayer/api": "9.0.0-canary.1",
+    "@intlayer/babel": "9.0.0-canary.1",
+    "@intlayer/chokidar": "9.0.0-canary.1",
+    "@intlayer/config": "9.0.0-canary.1",
+    "@intlayer/core": "9.0.0-canary.1",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.1",
+    "@intlayer/remote-dictionaries-entry": "9.0.0-canary.1",
+    "@intlayer/types": "9.0.0-canary.1",
+    "@intlayer/unmerged-dictionaries-entry": "9.0.0-canary.1",
     "commander": "14.0.3",
     "enquirer": "2.4.1",
     "eventsource": "4.1.0",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {
-    "@intlayer/ai": "9.0.0-canary.0",
+    "@intlayer/ai": "9.0.0-canary.1",
     "@types/node": "25.9.3",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -90,10 +90,10 @@
     "rimraf": "6.1.3",
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
-    "vitest": "4.1.8"
+    "vitest": "4.1.9"
   },
   "peerDependencies": {
-    "@intlayer/ai": "9.0.0-canary.0"
+    "@intlayer/ai": "9.0.0-canary.1"
   },
   "peerDependenciesMeta": {
     "@intlayer/ai": {

package/dist/cjs/translation-alignment/alignBlocks.cjs

@@ -1,68 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_translation_alignment_computeSimilarity = require('./computeSimilarity.cjs');
-
-//#region src/translation-alignment/alignBlocks.ts
-const alignEnglishAndFrenchBlocks = (defaultBlocks, secondaryBlocks) => {
-	const defaultLength = defaultBlocks.length;
-	const secondaryLength = secondaryBlocks.length;
-	const scoreMatrix = Array.from({ length: defaultLength + 1 }, () => Array.from({ length: secondaryLength + 1 }, () => 0));
-	const traceMatrix = Array.from({ length: defaultLength + 1 }, () => Array.from({ length: secondaryLength + 1 }, () => "diagonal"));
-	const gapPenalty = -2;
-	const computeMatchScore = (defaultIndex, secondaryIndex) => {
-		const defaultBlock = defaultBlocks[defaultIndex];
-		const secondaryBlock = secondaryBlocks[secondaryIndex];
-		const typeBonus = defaultBlock.type === secondaryBlock.type ? 2 : 0;
-		const anchorSimilarity = require_translation_alignment_computeSimilarity.computeJaccardSimilarity(defaultBlock.anchorText, secondaryBlock.anchorText, 3);
-		return typeBonus + (Math.min(defaultBlock.content.length, secondaryBlock.content.length) / Math.max(defaultBlock.content.length, secondaryBlock.content.length) > .75 ? 1 : 0) + anchorSimilarity * 8;
-	};
-	for (let i = 1; i <= defaultLength; i += 1) {
-		scoreMatrix[i][0] = scoreMatrix[i - 1][0] + gapPenalty;
-		traceMatrix[i][0] = "up";
-	}
-	for (let j = 1; j <= secondaryLength; j += 1) {
-		scoreMatrix[0][j] = scoreMatrix[0][j - 1] + gapPenalty;
-		traceMatrix[0][j] = "left";
-	}
-	for (let i = 1; i <= defaultLength; i += 1) for (let j = 1; j <= secondaryLength; j += 1) {
-		const match = scoreMatrix[i - 1][j - 1] + computeMatchScore(i - 1, j - 1);
-		const deleteGap = scoreMatrix[i - 1][j] + gapPenalty;
-		const insertGap = scoreMatrix[i][j - 1] + gapPenalty;
-		const best = Math.max(match, deleteGap, insertGap);
-		scoreMatrix[i][j] = best;
-		traceMatrix[i][j] = best === match ? "diagonal" : best === deleteGap ? "up" : "left";
-	}
-	const result = [];
-	let i = defaultLength;
-	let j = secondaryLength;
-	while (i > 0 || j > 0) if (i > 0 && j > 0 && traceMatrix[i][j] === "diagonal") {
-		const englishIndex = i - 1;
-		const frenchIndex = j - 1;
-		const similarityScore = require_translation_alignment_computeSimilarity.computeJaccardSimilarity(defaultBlocks[englishIndex].anchorText, secondaryBlocks[frenchIndex].anchorText, 3);
-		result.unshift({
-			englishIndex,
-			frenchIndex,
-			similarityScore
-		});
-		i -= 1;
-		j -= 1;
-	} else if (i > 0 && (j === 0 || traceMatrix[i][j] === "up")) {
-		result.unshift({
-			englishIndex: i - 1,
-			frenchIndex: null,
-			similarityScore: 0
-		});
-		i -= 1;
-	} else if (j > 0 && (i === 0 || traceMatrix[i][j] === "left")) {
-		result.unshift({
-			englishIndex: -1,
-			frenchIndex: j - 1,
-			similarityScore: 0
-		});
-		j -= 1;
-	}
-	return result;
-};
-
-//#endregion
-exports.alignEnglishAndFrenchBlocks = alignEnglishAndFrenchBlocks;
-//# sourceMappingURL=alignBlocks.cjs.map

package/dist/cjs/translation-alignment/alignBlocks.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"alignBlocks.cjs","names":["computeJaccardSimilarity"],"sources":["../../../src/translation-alignment/alignBlocks.ts"],"sourcesContent":["import { computeJaccardSimilarity } from './computeSimilarity';\nimport type { AlignmentPair, FingerprintedBlock } from './types';\n\nexport const alignEnglishAndFrenchBlocks = (\n  defaultBlocks: FingerprintedBlock[],\n  secondaryBlocks: FingerprintedBlock[]\n): AlignmentPair[] => {\n  // Needleman–Wunsch style global alignment using anchor similarity and type equality\n  const defaultLength = defaultBlocks.length;\n  const secondaryLength = secondaryBlocks.length;\n\n  const scoreMatrix: number[][] = Array.from(\n    { length: defaultLength + 1 },\n    () => Array.from({ length: secondaryLength + 1 }, () => 0)\n  );\n  const traceMatrix: ('diagonal' | 'up' | 'left')[][] = Array.from(\n    { length: defaultLength + 1 },\n    () => Array.from({ length: secondaryLength + 1 }, () => 'diagonal')\n  );\n\n  const gapPenalty = -2;\n\n  const computeMatchScore = (\n    defaultIndex: number,\n    secondaryIndex: number\n  ): number => {\n    const defaultBlock = defaultBlocks[defaultIndex];\n    const secondaryBlock = secondaryBlocks[secondaryIndex];\n    const typeBonus = defaultBlock.type === secondaryBlock.type ? 2 : 0;\n    const anchorSimilarity = computeJaccardSimilarity(\n      defaultBlock.anchorText,\n      secondaryBlock.anchorText,\n      3\n    );\n    const lengthRatio =\n      Math.min(defaultBlock.content.length, secondaryBlock.content.length) /\n      Math.max(defaultBlock.content.length, secondaryBlock.content.length);\n    const lengthBonus = lengthRatio > 0.75 ? 1 : 0;\n    return typeBonus + lengthBonus + anchorSimilarity * 8; // weighted toward anchor similarity\n  };\n\n  // initialize first row and column\n  for (let i = 1; i <= defaultLength; i += 1) {\n    scoreMatrix[i][0] = scoreMatrix[i - 1][0] + gapPenalty;\n    traceMatrix[i][0] = 'up';\n  }\n  for (let j = 1; j <= secondaryLength; j += 1) {\n    scoreMatrix[0][j] = scoreMatrix[0][j - 1] + gapPenalty;\n    traceMatrix[0][j] = 'left';\n  }\n\n  // fill\n  for (let i = 1; i <= defaultLength; i += 1) {\n    for (let j = 1; j <= secondaryLength; j += 1) {\n      const match = scoreMatrix[i - 1][j - 1] + computeMatchScore(i - 1, j - 1);\n      const deleteGap = scoreMatrix[i - 1][j] + gapPenalty;\n      const insertGap = scoreMatrix[i][j - 1] + gapPenalty;\n\n      const best = Math.max(match, deleteGap, insertGap);\n      scoreMatrix[i][j] = best;\n      traceMatrix[i][j] =\n        best === match ? 'diagonal' : best === deleteGap ? 'up' : 'left';\n    }\n  }\n\n  // traceback\n  const result: AlignmentPair[] = [];\n  let i = defaultLength;\n  let j = secondaryLength;\n  while (i > 0 || j > 0) {\n    if (i > 0 && j > 0 && traceMatrix[i][j] === 'diagonal') {\n      const englishIndex = i - 1;\n      const frenchIndex = j - 1;\n      const similarityScore = computeJaccardSimilarity(\n        defaultBlocks[englishIndex].anchorText,\n        secondaryBlocks[frenchIndex].anchorText,\n        3\n      );\n      result.unshift({ englishIndex, frenchIndex, similarityScore });\n      i -= 1;\n      j -= 1;\n    } else if (i > 0 && (j === 0 || traceMatrix[i][j] === 'up')) {\n      result.unshift({\n        englishIndex: i - 1,\n        frenchIndex: null,\n        similarityScore: 0,\n      });\n      i -= 1;\n    } else if (j > 0 && (i === 0 || traceMatrix[i][j] === 'left')) {\n      // french block has no corresponding english block (deleted)\n      result.unshift({\n        englishIndex: -1,\n        frenchIndex: j - 1,\n        similarityScore: 0,\n      });\n      j -= 1;\n    }\n  }\n  return result;\n};\n"],"mappings":";;;;AAGA,MAAa,+BACX,eACA,oBACoB;CAEpB,MAAM,gBAAgB,cAAc;CACpC,MAAM,kBAAkB,gBAAgB;CAExC,MAAM,cAA0B,MAAM,KACpC,EAAE,QAAQ,gBAAgB,GAAG,QACvB,MAAM,KAAK,EAAE,QAAQ,kBAAkB,GAAG,QAAQ,EAAE,CAC3D;CACD,MAAM,cAAgD,MAAM,KAC1D,EAAE,QAAQ,gBAAgB,GAAG,QACvB,MAAM,KAAK,EAAE,QAAQ,kBAAkB,GAAG,QAAQ,WAAW,CACpE;CAED,MAAM,aAAa;CAEnB,MAAM,qBACJ,cACA,mBACW;EACX,MAAM,eAAe,cAAc;EACnC,MAAM,iBAAiB,gBAAgB;EACvC,MAAM,YAAY,aAAa,SAAS,eAAe,OAAO,IAAI;EAClE,MAAM,mBAAmBA,yEACvB,aAAa,YACb,eAAe,YACf,EACD;AAKD,SAAO,aAHL,KAAK,IAAI,aAAa,QAAQ,QAAQ,eAAe,QAAQ,OAAO,GACpE,KAAK,IAAI,aAAa,QAAQ,QAAQ,eAAe,QAAQ,OAAO,GACpC,MAAO,IAAI,KACZ,mBAAmB;;AAItD,MAAK,IAAI,IAAI,GAAG,KAAK,eAAe,KAAK,GAAG;AAC1C,cAAY,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK;AAC5C,cAAY,GAAG,KAAK;;AAEtB,MAAK,IAAI,IAAI,GAAG,KAAK,iBAAiB,KAAK,GAAG;AAC5C,cAAY,GAAG,KAAK,YAAY,GAAG,IAAI,KAAK;AAC5C,cAAY,GAAG,KAAK;;AAItB,MAAK,IAAI,IAAI,GAAG,KAAK,eAAe,KAAK,EACvC,MAAK,IAAI,IAAI,GAAG,KAAK,iBAAiB,KAAK,GAAG;EAC5C,MAAM,QAAQ,YAAY,IAAI,GAAG,IAAI,KAAK,kBAAkB,IAAI,GAAG,IAAI,EAAE;EACzE,MAAM,YAAY,YAAY,IAAI,GAAG,KAAK;EAC1C,MAAM,YAAY,YAAY,GAAG,IAAI,KAAK;EAE1C,MAAM,OAAO,KAAK,IAAI,OAAO,WAAW,UAAU;AAClD,cAAY,GAAG,KAAK;AACpB,cAAY,GAAG,KACb,SAAS,QAAQ,aAAa,SAAS,YAAY,OAAO;;CAKhE,MAAM,SAA0B,EAAE;CAClC,IAAI,IAAI;CACR,IAAI,IAAI;AACR,QAAO,IAAI,KAAK,IAAI,EAClB,KAAI,IAAI,KAAK,IAAI,KAAK,YAAY,GAAG,OAAO,YAAY;EACtD,MAAM,eAAe,IAAI;EACzB,MAAM,cAAc,IAAI;EACxB,MAAM,kBAAkBA,yEACtB,cAAc,cAAc,YAC5B,gBAAgB,aAAa,YAC7B,EACD;AACD,SAAO,QAAQ;GAAE;GAAc;GAAa;GAAiB,CAAC;AAC9D,OAAK;AACL,OAAK;YACI,IAAI,MAAM,MAAM,KAAK,YAAY,GAAG,OAAO,OAAO;AAC3D,SAAO,QAAQ;GACb,cAAc,IAAI;GAClB,aAAa;GACb,iBAAiB;GAClB,CAAC;AACF,OAAK;YACI,IAAI,MAAM,MAAM,KAAK,YAAY,GAAG,OAAO,SAAS;AAE7D,SAAO,QAAQ;GACb,cAAc;GACd,aAAa,IAAI;GACjB,iBAAiB;GAClB,CAAC;AACF,OAAK;;AAGT,QAAO"}

package/dist/cjs/translation-alignment/computeSimilarity.cjs

@@ -1,26 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-//#region src/translation-alignment/computeSimilarity.ts
-const generateCharacterShingles = (text, shingleLength) => {
-	const normalized = text.replace(/\s+/g, " ").trim();
-	const set = /* @__PURE__ */ new Set();
-	if (normalized.length < shingleLength) {
-		if (normalized.length > 0) set.add(normalized);
-		return set;
-	}
-	for (let index = 0; index <= normalized.length - shingleLength; index += 1) set.add(normalized.slice(index, index + shingleLength));
-	return set;
-};
-const computeJaccardSimilarity = (a, b, shingleLength = 3) => {
-	const setA = generateCharacterShingles(a, shingleLength);
-	const setB = generateCharacterShingles(b, shingleLength);
-	if (setA.size === 0 && setB.size === 0) return 1;
-	const intersectionSize = Array.from(setA).filter((token) => setB.has(token)).length;
-	const unionSize = new Set([...Array.from(setA), ...Array.from(setB)]).size;
-	return unionSize === 0 ? 0 : intersectionSize / unionSize;
-};
-
-//#endregion
-exports.computeJaccardSimilarity = computeJaccardSimilarity;
-exports.generateCharacterShingles = generateCharacterShingles;
-//# sourceMappingURL=computeSimilarity.cjs.map

package/dist/cjs/translation-alignment/computeSimilarity.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeSimilarity.cjs","names":[],"sources":["../../../src/translation-alignment/computeSimilarity.ts"],"sourcesContent":["// Character shingle Jaccard similarity (language agnostic)\nexport const generateCharacterShingles = (\n  text: string,\n  shingleLength: number\n): Set<string> => {\n  const normalized = text.replace(/\\s+/g, ' ').trim();\n  const set = new Set<string>();\n  if (normalized.length < shingleLength) {\n    if (normalized.length > 0) {\n      set.add(normalized);\n    }\n    return set;\n  }\n  for (let index = 0; index <= normalized.length - shingleLength; index += 1) {\n    set.add(normalized.slice(index, index + shingleLength));\n  }\n  return set;\n};\n\nexport const computeJaccardSimilarity = (\n  a: string,\n  b: string,\n  shingleLength: number = 3\n): number => {\n  const setA = generateCharacterShingles(a, shingleLength);\n  const setB = generateCharacterShingles(b, shingleLength);\n  if (setA.size === 0 && setB.size === 0) return 1;\n  const intersectionSize = Array.from(setA).filter((token) =>\n    setB.has(token)\n  ).length;\n  const unionSize = new Set([...Array.from(setA), ...Array.from(setB)]).size;\n  return unionSize === 0 ? 0 : intersectionSize / unionSize;\n};\n"],"mappings":";;;AACA,MAAa,6BACX,MACA,kBACgB;CAChB,MAAM,aAAa,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM;CACnD,MAAM,sBAAM,IAAI,KAAa;AAC7B,KAAI,WAAW,SAAS,eAAe;AACrC,MAAI,WAAW,SAAS,EACtB,KAAI,IAAI,WAAW;AAErB,SAAO;;AAET,MAAK,IAAI,QAAQ,GAAG,SAAS,WAAW,SAAS,eAAe,SAAS,EACvE,KAAI,IAAI,WAAW,MAAM,OAAO,QAAQ,cAAc,CAAC;AAEzD,QAAO;;AAGT,MAAa,4BACX,GACA,GACA,gBAAwB,MACb;CACX,MAAM,OAAO,0BAA0B,GAAG,cAAc;CACxD,MAAM,OAAO,0BAA0B,GAAG,cAAc;AACxD,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,EAAG,QAAO;CAC/C,MAAM,mBAAmB,MAAM,KAAK,KAAK,CAAC,QAAQ,UAChD,KAAK,IAAI,MAAM,CAChB,CAAC;CACF,MAAM,YAAY,IAAI,IAAI,CAAC,GAAG,MAAM,KAAK,KAAK,EAAE,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC;AACtE,QAAO,cAAc,IAAI,IAAI,mBAAmB"}

package/dist/cjs/translation-alignment/fingerprintBlock.cjs

@@ -1,24 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let node_crypto = require("node:crypto");
-node_crypto = require_runtime.__toESM(node_crypto);
-
-//#region src/translation-alignment/fingerprintBlock.ts
-const computeStringDigest = (text) => node_crypto.default.createHash("sha256").update(text).digest("hex");
-const fingerprintBlock = (block, previousBlock, nextBlock) => {
-	const semanticDigest = computeStringDigest(block.semanticText);
-	const anchorDigest = computeStringDigest(block.anchorText);
-	const compositeKey = `${semanticDigest}:${anchorDigest}`;
-	const contextKey = computeStringDigest(`${computeStringDigest(previousBlock?.semanticText ?? "")}:${computeStringDigest(nextBlock?.semanticText ?? "")}`);
-	return {
-		...block,
-		semanticDigest,
-		anchorDigest,
-		compositeKey,
-		contextKey
-	};
-};
-
-//#endregion
-exports.fingerprintBlock = fingerprintBlock;
-//# sourceMappingURL=fingerprintBlock.cjs.map

package/dist/cjs/translation-alignment/fingerprintBlock.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"fingerprintBlock.cjs","names":["crypto"],"sources":["../../../src/translation-alignment/fingerprintBlock.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { FingerprintedBlock, NormalizedBlock } from './types';\n\nconst computeStringDigest = (text: string): string =>\n  crypto.createHash('sha256').update(text).digest('hex');\n\nexport const fingerprintBlock = (\n  block: NormalizedBlock,\n  previousBlock: NormalizedBlock | null,\n  nextBlock: NormalizedBlock | null\n): FingerprintedBlock => {\n  const semanticDigest = computeStringDigest(block.semanticText);\n  const anchorDigest = computeStringDigest(block.anchorText);\n  const compositeKey = `${semanticDigest}:${anchorDigest}`;\n\n  const previousDigest = computeStringDigest(previousBlock?.semanticText ?? '');\n  const nextDigest = computeStringDigest(nextBlock?.semanticText ?? '');\n  const contextKey = computeStringDigest(`${previousDigest}:${nextDigest}`);\n\n  return {\n    ...block,\n    semanticDigest,\n    anchorDigest,\n    compositeKey,\n    contextKey,\n  };\n};\n"],"mappings":";;;;;;AAGA,MAAM,uBAAuB,SAC3BA,oBAAO,WAAW,SAAS,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM;AAExD,MAAa,oBACX,OACA,eACA,cACuB;CACvB,MAAM,iBAAiB,oBAAoB,MAAM,aAAa;CAC9D,MAAM,eAAe,oBAAoB,MAAM,WAAW;CAC1D,MAAM,eAAe,GAAG,eAAe,GAAG;CAI1C,MAAM,aAAa,oBAAoB,GAFhB,oBAAoB,eAAe,gBAAgB,GAElB,CAAC,GADtC,oBAAoB,WAAW,gBAAgB,GACI,GAAG;AAEzE,QAAO;EACL,GAAG;EACH;EACA;EACA;EACA;EACD"}