@contentrain/mcp 3.2.0 → 3.3.0

package/README.md

@@ -96,7 +96,7 @@ All write operations are designed around git-backed safety:
 | `contentrain_branch_delete` | Delete a stale/failed `cr/*` branch locally and on the remote (contentrain branch protected) | — | **Yes** |
 | `contentrain_scan` | Graph- and candidate-based hardcoded string scan | Yes | — |
 | `contentrain_apply` | Normalize extract/reuse execution with dry-run support | — | — |
-| `contentrain_bulk` | Bulk locale copy, status updates, and deletes | — | — |
+| `contentrain_bulk` | Bulk locale copy, status updates, and deletes (`dry_run` previews) | — | — |
 | `contentrain_media_list` | List media assets (search, tag filter, cursor pagination) | Yes | — |
 | `contentrain_media_get` | Get one media asset by id | Yes | — |
 | `contentrain_media_ingest` | Ingest an asset from a source URL (provider fetches server-side) | — | — |

package/dist/index.mjs

@@ -15,7 +15,7 @@ import "./transaction-BR2jg4uj.mjs";
 import "./local-DbPlR0Br.mjs";
 import "./detect-CI32ynpq.mjs";
 import "./annotations-CXHPnS-M.mjs";
-import { n as createServer } from "./server-ChpsLHlF.mjs";
+import { n as createServer } from "./server-CFjIoTWt.mjs";
 import "./errors-BmLE-JSC.mjs";
 import "./reconcile-EANDIp_T.mjs";
 import "./scan-config-C5zzygeH.mjs";

package/dist/server/http/index.mjs

@@ -14,7 +14,7 @@ import "../../transaction-BR2jg4uj.mjs";
 import "../../local-DbPlR0Br.mjs";
 import "../../detect-CI32ynpq.mjs";
 import "../../annotations-CXHPnS-M.mjs";
-import { n as createServer } from "../../server-ChpsLHlF.mjs";
+import { n as createServer } from "../../server-CFjIoTWt.mjs";
 import "../../errors-BmLE-JSC.mjs";
 import "../../reconcile-EANDIp_T.mjs";
 import "../../scan-config-C5zzygeH.mjs";

package/dist/{server-ChpsLHlF.mjs → server-CFjIoTWt.mjs}

@@ -2412,7 +2412,7 @@ function registerNormalizeTools(server, provider, projectRoot) {
 //#endregion
 //#region src/tools/bulk.ts
 function registerBulkTools(server, _provider, projectRoot) {
-	server.tool("contentrain_bulk", "Batch operations on content entries. All operations are auto-committed to git.", {
+	server.tool("contentrain_bulk", "Batch operations on content entries. All operations are auto-committed to git. DRY RUN (dry_run:true): runs the whole operation in a throwaway worktree and reports exactly what would change — nothing is committed and no branch survives. Recommended workflow: preview with dry_run:true, review the counts, then call again to execute.", {
 		operation: z.enum([
 			"copy_locale",
 			"update_status",
@@ -2431,7 +2431,8 @@ function registerBulkTools(server, _provider, projectRoot) {
 			"rejected",
 			"archived"
 		]).optional().describe("New status for update_status"),
-		confirm: z.boolean().optional().describe("Must be true for delete_entries")
+		confirm: z.boolean().optional().describe("Must be true for delete_entries (not needed while dry_run:true — a preview deletes nothing)"),
+		dry_run: z.boolean().optional().describe("Preview mode: perform the operation in a throwaway worktree and report what would change, committing nothing. Defaults to false so existing callers keep executing.")
 	}, TOOL_ANNOTATIONS["contentrain_bulk"], async (input) => {
 		if (!projectRoot) return capabilityError("contentrain_bulk", "localWorktree");
 		const config = await readConfig(projectRoot);
@@ -2503,12 +2504,15 @@ function registerBulkTools(server, _provider, projectRoot) {
 				const tx = await createTransaction(projectRoot, branch);
 				try {
 					let copiedCount = 0;
+					let replacedCount = 0;
 					await tx.write(async (wt) => {
 						const cDir = resolveContentDir(wt, model);
 						const sourceFile = resolveJsonFilePath(cDir, model, input.source_locale);
 						const targetFile = resolveJsonFilePath(cDir, model, input.target_locale);
 						const sourceData = await readJson(sourceFile);
 						if (!sourceData) throw new Error(`No content found for locale "${input.source_locale}" in model "${input.model}"`);
+						const targetData = await readJson(targetFile);
+						if (targetData) replacedCount = model.kind === "collection" ? Object.keys(targetData).length : 1;
 						await writeJson(targetFile, sourceData);
 						if (model.kind === "collection") {
 							const entries = sourceData;
@@ -2526,6 +2530,21 @@ function registerBulkTools(server, _provider, projectRoot) {
 							copiedCount = 1;
 						}
 					});
+					if (input.dry_run) {
+						await tx.cleanup();
+						return { content: [{
+							type: "text",
+							text: JSON.stringify({
+								status: "preview",
+								dry_run: true,
+								operation: "copy_locale",
+								message: `Would copy ${copiedCount} entries from ${input.source_locale} to ${input.target_locale}.`,
+								would_copy: copiedCount,
+								would_replace: replacedCount,
+								next_steps: replacedCount > 0 ? [`${replacedCount} record(s) already exist in "${input.target_locale}" and would be REPLACED — confirm that is intended`, "Call contentrain_bulk again without dry_run to execute"] : ["Call contentrain_bulk again without dry_run to execute"]
+							}, null, 2)
+						}] };
+					}
 					await tx.commit(`[contentrain] bulk: copy ${input.source_locale} → ${input.target_locale} for ${input.model}`, {
 						tool: "contentrain_bulk",
 						model: input.model,
@@ -2690,6 +2709,22 @@ function registerBulkTools(server, _provider, projectRoot) {
 							isError: true
 						};
 					}
+					if (input.dry_run) {
+						await tx.cleanup();
+						return { content: [{
+							type: "text",
+							text: JSON.stringify({
+								status: "preview",
+								dry_run: true,
+								operation: "update_status",
+								message: `Would update ${updatedCount} meta record(s) to status "${input.status}" across locales [${Object.keys(updatedPerLocale).join(", ")}].`,
+								would_update: updatedCount,
+								would_update_by_locale: updatedPerLocale,
+								not_found: notFound.length > 0 ? notFound : void 0,
+								next_steps: ["Call contentrain_bulk again without dry_run to execute"]
+							}, null, 2)
+						}] };
+					}
 					await tx.commit(`[contentrain] bulk: update status → ${input.status} for ${input.model}`, {
 						tool: "contentrain_bulk",
 						model: input.model,
@@ -2739,10 +2774,13 @@ function registerBulkTools(server, _provider, projectRoot) {
 					}],
 					isError: true
 				};
-				if (input.confirm !== true) return {
+				if (!input.dry_run && input.confirm !== true) return {
 					content: [{
 						type: "text",
-						text: JSON.stringify({ error: "delete_entries requires confirm:true" })
+						text: JSON.stringify({
+							error: "delete_entries requires confirm:true",
+							hint: "Run with dry_run:true first to see which files would be removed — no confirmation needed for a preview."
+						})
 					}],
 					isError: true
 				};
@@ -2766,6 +2804,21 @@ function registerBulkTools(server, _provider, projectRoot) {
 							allRemoved.push(...removed);
 						}
 					});
+					if (input.dry_run) {
+						await tx.cleanup();
+						return { content: [{
+							type: "text",
+							text: JSON.stringify({
+								status: "preview",
+								dry_run: true,
+								operation: "delete_entries",
+								message: `Would delete ${input.entry_ids.length} entries, removing ${allRemoved.length} file(s).`,
+								would_delete: input.entry_ids.length,
+								files_to_remove: allRemoved,
+								next_steps: ["Call contentrain_bulk again with dry_run:false and confirm:true to execute"]
+							}, null, 2)
+						}] };
+					}
 					await tx.commit(`[contentrain] bulk: delete ${input.entry_ids.length} entries from ${input.model}`, {
 						tool: "contentrain_bulk",
 						model: input.model,
@@ -2959,7 +3012,7 @@ function registerMediaTools(server, provider, _projectRoot) {
 }
 //#endregion
 //#region package.json
-var version = "3.2.0";
+var version = "3.3.0";
 //#endregion
 //#region src/server.ts
 /**
@@ -3034,4 +3087,4 @@ function resolveServerContext(input) {
 //#endregion
 export { createServer as n, DEFAULT_INSTRUCTIONS as t };
 
-//# sourceMappingURL=server-ChpsLHlF.mjs.map
+//# sourceMappingURL=server-CFjIoTWt.mjs.map