@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/serialization/tasks/helpers/filesystem.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyFilesystemCommands = void 0;
-const filesystem_store_1 = require("../../filesystem-store");
+const items_1 = require("../../filesystem-store/items");
 const applyFilesystemCommands = async (commands, pathProvider, sourceData, logger) => {
     const processedIds = [];
     for (const command of commands) {
         if (command.type === "recycle") {
-            await (0, filesystem_store_1.removeItemFromFilesystem)(pathProvider, command.source);
+            await (0, items_1.removeItemFromFilesystem)(pathProvider, command.source);
             logger.info(command.source.path.toPathString(), "yellow");
             continue;
         }
@@ -16,10 +16,10 @@ const applyFilesystemCommands = async (commands, pathProvider, sourceData, logge
         }
         if (command.type === "move" || command.type === "rename") {
             if (command.destination) {
-                await (0, filesystem_store_1.removeItemFromFilesystem)(pathProvider, command.destination);
+                await (0, items_1.removeItemFromFilesystem)(pathProvider, command.destination);
             }
         }
-        await (0, filesystem_store_1.writeItemToFilesystem)(pathProvider, itemData);
+        await (0, items_1.writeItemToFilesystem)(pathProvider, itemData);
         processedIds.push(itemData.id);
     }
     return processedIds;

package/dist/serialization/tasks/helpers/items.d.ts

@@ -1,3 +1,2 @@
 import { ItemData } from "../../types";
 export declare const buildItemDataMap: (items: ItemData[]) => Map<string, ItemData>;
-//# sourceMappingURL=items.d.ts.map

package/dist/serialization/tasks/helpers/sitecore.d.ts

@@ -1,5 +1,4 @@
-import { readRootConfiguration } from "../../../config";
+import { readRootConfiguration } from "../../../config/root-config";
 import { Logger } from "../../../shared/logger";
 import { ItemCommand } from "../../commands";
 export declare const applySitecoreCommands: (root: ReturnType<typeof readRootConfiguration>, environmentName: string, database: string, commands: ItemCommand[], logger: Logger, whatIf?: boolean) => Promise<string[]>;
-//# sourceMappingURL=sitecore.d.ts.map

package/dist/serialization/tasks/helpers/sitecore.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.applySitecoreCommands = void 0;
-const sitecore_api_1 = require("../../sitecore-api");
+const items_1 = require("../../api/items");
 const shared_1 = require("../shared");
 const applySitecoreCommands = async (root, environmentName, database, commands, logger, whatIf) => {
     if (whatIf || commands.length === 0) {
@@ -92,7 +92,7 @@ const applySitecoreCommands = async (root, environmentName, database, commands,
         .filter(Boolean);
     const env = root.environments[environmentName];
     const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
-    const results = await (0, sitecore_api_1.executeSerializationCommands)(env, commandsByType, "Information", {
+    const results = await (0, items_1.executeSerializationCommands)(env, commandsByType, "Information", {
         timeoutMs: apiTimeoutMs,
     });
     for (const result of results) {

package/dist/serialization/tasks/info.d.ts

@@ -1,4 +1,3 @@
 import type { CommonOptions, ExplainOptions } from "./types";
 export declare const runInfo: (options: CommonOptions) => Promise<void>;
 export declare const runExplain: (options: ExplainOptions) => Promise<void>;
-//# sourceMappingURL=info.d.ts.map

package/dist/serialization/tasks/package.d.ts

@@ -1,4 +1,3 @@
 import type { PackageCreateOptions, PackageInstallOptions } from "./types";
 export declare const runPackageCreate: (options: PackageCreateOptions) => Promise<void>;
 export declare const runPackageInstall: (options: PackageInstallOptions) => Promise<void>;
-//# sourceMappingURL=package.d.ts.map

package/dist/serialization/tasks/package.js

@@ -8,14 +8,19 @@ const node_path_1 = __importDefault(require("node:path"));
 const promises_1 = __importDefault(require("node:fs/promises"));
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
-const config_1 = require("../../config");
+const root_config_1 = require("../../config/root-config");
+const modules_1 = require("../../config/modules");
 const field_filter_1 = require("../field-filter");
-const sitecore_api_1 = require("../sitecore-api");
-const filesystem_store_1 = require("../filesystem-store");
+const items_1 = require("../api/items");
+const roles_1 = require("../filesystem-store/roles");
+const users_1 = require("../filesystem-store/users");
 const yaml_1 = require("../yaml");
 const shared_1 = require("./shared");
-const helpers_1 = require("./helpers");
-const commands_1 = require("../commands");
+const sitecore_1 = require("./helpers/sitecore");
+const commands_1 = require("./helpers/commands");
+const items_2 = require("./helpers/items");
+const collect_1 = require("./helpers/collect");
+const commands_2 = require("../commands");
 const exists = async (value) => {
     try {
         await promises_1.default.access(value);
@@ -62,14 +67,14 @@ const runPackageCreate = async (options) => {
                 zip.addFile(entryPath, await promises_1.default.readFile(file));
             }
         }
-        const roles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
+        const roles = await (0, roles_1.readRolesFromFilesystem)(root, module);
         for (const role of roles) {
             const rolePath = role.serializedItemId ?? "";
             const relative = node_path_1.default.relative(node_path_1.default.dirname(module.sourceIdentifier), rolePath);
             const entryPath = node_path_1.default.posix.join(module.namespace, relative.split(node_path_1.default.sep).join("/"));
             zip.addFile(entryPath, Buffer.from((0, yaml_1.writeRoleYaml)(role)));
         }
-        const users = await (0, filesystem_store_1.readUsersFromFilesystem)(root, module);
+        const users = await (0, users_1.readUsersFromFilesystem)(root, module);
         for (const user of users) {
             const userPath = user.serializedItemId ?? "";
             const relative = node_path_1.default.relative(node_path_1.default.dirname(module.sourceIdentifier), userPath);
@@ -91,7 +96,7 @@ const runPackageCreate = async (options) => {
 exports.runPackageCreate = runPackageCreate;
 const runPackageInstall = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
-    const root = (0, config_1.readRootConfiguration)(options.config ?? process.cwd());
+    const root = (0, root_config_1.readRootConfiguration)(options.config ?? process.cwd());
     const envName = options.environmentName ?? root.defaultEnvironment;
     const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
     const summary = {
@@ -121,7 +126,7 @@ const runPackageInstall = async (options) => {
             continue;
         }
         const raw = JSON.parse(entry.getData().toString("utf8"));
-        moduleConfigs.push((0, config_1.normalizeModuleConfiguration)(raw, modulePath, root));
+        moduleConfigs.push((0, modules_1.normalizeModuleConfiguration)(raw, modulePath, root));
     }
     const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(moduleConfigs);
     const entries = zip.getEntries().filter((entry) => entry.entryName.endsWith(".yml"));
@@ -146,10 +151,10 @@ const runPackageInstall = async (options) => {
         const destinationMetadata = [];
         for (const subtree of subtrees) {
             const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
-            const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, false, { timeoutMs: apiTimeoutMs });
+            const metadata = await (0, items_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, false, { timeoutMs: apiTimeoutMs });
             destinationMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
         }
-        const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, packageMetadata, destinationMetadata, true);
+        const commands = (0, commands_1.buildCommandsForDatabase)(subtrees, packageMetadata, destinationMetadata, true);
         const changes = commands.length;
         summary.totalChanges += changes;
         summary.databases.push({
@@ -158,11 +163,11 @@ const runPackageInstall = async (options) => {
             applied: changes > 0 && !options.whatIf,
         });
         const sourceDataMap = new Map(packageItems.map((item) => [item.id, item]));
-        const destData = await (0, helpers_1.collectItemData)(envName, root, subtrees, false);
-        const destDataMap = (0, helpers_1.buildItemDataMap)(destData.items);
-        (0, commands_1.enrichCreateCommands)(commands, sourceDataMap);
-        (0, commands_1.enrichUpdateCommands)(commands, sourceDataMap, destDataMap, true);
-        await (0, helpers_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
+        const destData = await (0, collect_1.collectItemData)(envName, root, subtrees, false);
+        const destDataMap = (0, items_2.buildItemDataMap)(destData.items);
+        (0, commands_2.enrichCreateCommands)(commands, sourceDataMap);
+        (0, commands_2.enrichUpdateCommands)(commands, sourceDataMap, destDataMap, true);
+        await (0, sitecore_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
     }
     if (logger.isJson()) {
         logger.json(summary);

package/dist/serialization/tasks/pull.d.ts

@@ -1,3 +1,2 @@
 import type { SyncOptions } from "./types";
 export declare const runPull: (options: SyncOptions) => Promise<void>;
-//# sourceMappingURL=pull.d.ts.map

package/dist/serialization/tasks/pull.js

@@ -3,12 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPull = void 0;
 const path_provider_1 = require("../path-provider");
 const field_filter_1 = require("../field-filter");
-const sitecore_api_1 = require("../sitecore-api");
-const filesystem_store_1 = require("../filesystem-store");
+const items_1 = require("../api/items");
+const items_2 = require("../filesystem-store/items");
 const spinner_1 = require("../../shared/spinner");
 const shared_1 = require("./shared");
 const commands_1 = require("../commands");
-const helpers_1 = require("./helpers");
+const filesystem_1 = require("./helpers/filesystem");
+const commands_2 = require("./helpers/commands");
+const items_3 = require("./helpers/items");
+const collect_1 = require("./helpers/collect");
 const roles_1 = require("./roles");
 const users_1 = require("./users");
 const runPull = async (options) => {
@@ -25,16 +28,21 @@ const runPull = async (options) => {
     };
     const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(modules);
     for (const [database, subtrees] of subtreesByDb) {
+        if (options.signal?.aborted) {
+            options.emit?.({ kind: "database-skipped", database, reason: "cancelled-by-client" });
+            break;
+        }
+        options.emit?.({ kind: "database-start", database, subtreeCount: subtrees.length });
         const spinner = await (0, spinner_1.startSpinner)(`Pulling ${database} items`);
         try {
             const sourceMetadata = [];
             for (const subtree of subtrees) {
                 const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
-                const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
+                const metadata = await (0, items_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
                 sourceMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
             }
-            const { items: destinationItems, metadata: destinationMetadata } = await (0, filesystem_store_1.loadFilesystemItems)(subtrees);
-            const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, false);
+            const { items: destinationItems, metadata: destinationMetadata } = await (0, items_2.loadFilesystemItems)(subtrees);
+            const commands = (0, commands_2.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, false);
             const changes = commands.length;
             summary.totalChanges += changes;
             summary.databases.push({
@@ -42,6 +50,7 @@ const runPull = async (options) => {
                 changes,
                 applied: changes > 0 && !options.whatIf,
             });
+            options.emit?.({ kind: "database-changes-detected", database, changes });
             if (changes === 0) {
                 if (!logger.isJson()) {
                     logger.info(`No changes detected for ${database}.`, "green");
@@ -59,11 +68,17 @@ const runPull = async (options) => {
                 spinner?.succeed();
                 continue;
             }
-            const dataMap = (0, helpers_1.buildItemDataMap)((await (0, helpers_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures))).items);
+            const dataMap = (0, items_3.buildItemDataMap)((await (0, collect_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures))).items);
             (0, commands_1.enrichCreateCommands)(commands, dataMap);
-            (0, commands_1.enrichUpdateCommands)(commands, dataMap, (0, helpers_1.buildItemDataMap)(destinationItems), false);
+            (0, commands_1.enrichUpdateCommands)(commands, dataMap, (0, items_3.buildItemDataMap)(destinationItems), false);
             const pathProvider = new path_provider_1.FilesystemPathProvider(subtrees);
-            await (0, helpers_1.applyFilesystemCommands)(commands, pathProvider, dataMap, logger);
+            await (0, filesystem_1.applyFilesystemCommands)(commands, pathProvider, dataMap, logger);
+            options.emit?.({
+                kind: "database-applied",
+                database,
+                changes,
+                whatIf: Boolean(options.whatIf),
+            });
             spinner?.succeed();
         }
         catch (error) {

package/dist/serialization/tasks/push.d.ts

@@ -1,3 +1,2 @@
 import type { SyncOptions } from "./types";
 export declare const runPush: (options: SyncOptions) => Promise<void>;
-//# sourceMappingURL=push.d.ts.map

package/dist/serialization/tasks/push.js

@@ -2,12 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPush = void 0;
 const field_filter_1 = require("../field-filter");
-const sitecore_api_1 = require("../sitecore-api");
-const filesystem_store_1 = require("../filesystem-store");
+const items_1 = require("../api/items");
+const publish_1 = require("../api/publish");
+const items_2 = require("../filesystem-store/items");
 const spinner_1 = require("../../shared/spinner");
 const shared_1 = require("./shared");
 const commands_1 = require("../commands");
-const helpers_1 = require("./helpers");
+const sitecore_1 = require("./helpers/sitecore");
+const commands_2 = require("./helpers/commands");
+const items_3 = require("./helpers/items");
+const collect_1 = require("./helpers/collect");
 const roles_1 = require("./roles");
 const users_1 = require("./users");
 const runPush = async (options) => {
@@ -34,18 +38,24 @@ const runPush = async (options) => {
     }
     const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(modules);
     for (const [database, subtrees] of subtreesByDb) {
+        if (options.signal?.aborted) {
+            options.emit?.({ kind: "database-skipped", database, reason: "cancelled-by-client" });
+            break;
+        }
+        options.emit?.({ kind: "database-start", database, subtreeCount: subtrees.length });
         const spinner = await (0, spinner_1.startSpinner)(`Pushing ${database} items`);
         try {
-            const { items: sourceItems, metadata: sourceMetadata } = await (0, filesystem_store_1.loadFilesystemItems)(subtrees);
+            const { items: sourceItems, metadata: sourceMetadata } = await (0, items_2.loadFilesystemItems)(subtrees);
             const destinationMetadata = [];
             for (const subtree of subtrees) {
                 const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
-                const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
+                const metadata = await (0, items_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
                 destinationMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
             }
-            const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, true);
+            const commands = (0, commands_2.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, true);
             const changes = commands.length;
             summary.totalChanges += changes;
+            options.emit?.({ kind: "database-changes-detected", database, changes });
             const summaryEntry = {
                 database,
                 changes,
@@ -63,16 +73,16 @@ const runPush = async (options) => {
             if (options.whatIf && !logger.isJson()) {
                 logger.info("What if mode is active. No changes will be made.", "yellow");
             }
-            const sourceDataMap = (0, helpers_1.buildItemDataMap)(sourceItems);
-            const destData = await (0, helpers_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures));
-            const destDataMap = (0, helpers_1.buildItemDataMap)(destData.items);
+            const sourceDataMap = (0, items_3.buildItemDataMap)(sourceItems);
+            const destData = await (0, collect_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures));
+            const destDataMap = (0, items_3.buildItemDataMap)(destData.items);
             (0, commands_1.enrichCreateCommands)(commands, sourceDataMap);
             (0, commands_1.enrichUpdateCommands)(commands, sourceDataMap, destDataMap, true);
-            const processedIds = await (0, helpers_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
+            const processedIds = await (0, sitecore_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
             if (options.publish && processedIds.length > 0 && !options.whatIf) {
                 const targets = options.targets && options.targets.length > 0 ? options.targets : [undefined];
                 for (const target of targets) {
-                    await (0, sitecore_api_1.publishItems)(root.environments[envName], processedIds, target, {
+                    await (0, publish_1.publishItems)(root.environments[envName], processedIds, target, {
                         timeoutMs: apiTimeoutMs,
                     });
                 }
@@ -82,6 +92,12 @@ const runPush = async (options) => {
                     logger.info("Publishing is finished.", "green");
                 }
             }
+            options.emit?.({
+                kind: "database-applied",
+                database,
+                changes,
+                whatIf: Boolean(options.whatIf),
+            });
             spinner?.succeed();
             summary.databases.push(summaryEntry);
         }

package/dist/serialization/tasks/roles.d.ts

@@ -1,6 +1,6 @@
-import { readRootConfiguration, SerializationModuleConfiguration } from "../../config";
+import { readRootConfiguration } from "../../config/root-config";
+import type { SerializationModuleConfiguration } from "../../config/types";
 import { Logger } from "../../shared/logger";
 export declare const rolesEqual: (left: string[], right: string[]) => boolean;
 export declare const syncRolesPull: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
 export declare const syncRolesPush: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
-//# sourceMappingURL=roles.d.ts.map

package/dist/serialization/tasks/roles.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.syncRolesPush = exports.syncRolesPull = exports.rolesEqual = void 0;
-const sitecore_api_1 = require("../sitecore-api");
-const filesystem_store_1 = require("../filesystem-store");
+const roles_1 = require("../api/roles");
+const roles_2 = require("../filesystem-store/roles");
 const shared_1 = require("./shared");
 const normalizeRoleMembers = (roles) => [...roles].map((role) => role.toLowerCase()).sort();
 const rolesEqual = (left, right) => {
@@ -20,22 +20,22 @@ const syncRolesPull = async (root, module, environmentName, logger) => {
     }
     const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
     const predicates = module.roles.map((role) => ({ domain: role.domain, pattern: role.pattern }));
-    const sourceRoles = await (0, sitecore_api_1.fetchRoles)(root.environments[environmentName], predicates, {
+    const sourceRoles = await (0, roles_1.fetchRoles)(root.environments[environmentName], predicates, {
         timeoutMs: apiTimeoutMs,
     });
-    const destRoles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
+    const destRoles = await (0, roles_2.readRolesFromFilesystem)(root, module);
     const destMap = new Map(destRoles.map((role) => [role.roleName.toLowerCase(), role]));
     for (const role of sourceRoles) {
         const existing = destMap.get(role.roleName.toLowerCase());
         if (!existing || !(0, exports.rolesEqual)(existing.memberOfRoles, role.memberOfRoles)) {
-            await (0, filesystem_store_1.writeRoleToFilesystem)(root, module, role);
+            await (0, roles_2.writeRoleToFilesystem)(root, module, role);
         }
     }
     if (root.serialization.removeOrphansForRoles) {
         const sourceNames = new Set(sourceRoles.map((role) => role.roleName.toLowerCase()));
         for (const dest of destRoles) {
             if (!sourceNames.has(dest.roleName.toLowerCase())) {
-                await (0, filesystem_store_1.removeRoleFromFilesystem)(dest.serializedItemId);
+                await (0, roles_2.removeRoleFromFilesystem)(dest.serializedItemId);
             }
         }
     }
@@ -48,8 +48,8 @@ const syncRolesPush = async (root, module, environmentName, logger) => {
     }
     const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
     const predicates = module.roles.map((role) => ({ domain: role.domain, pattern: role.pattern }));
-    const sourceRoles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
-    const destinationRoles = await (0, sitecore_api_1.fetchRoles)(root.environments[environmentName], predicates, {
+    const sourceRoles = await (0, roles_2.readRolesFromFilesystem)(root, module);
+    const destinationRoles = await (0, roles_1.fetchRoles)(root.environments[environmentName], predicates, {
         timeoutMs: apiTimeoutMs,
     });
     const destMap = new Map(destinationRoles.map((role) => [role.roleName.toLowerCase(), role]));
@@ -94,7 +94,7 @@ const syncRolesPush = async (root, module, environmentName, logger) => {
         }
     }
     if (commands.length > 0) {
-        await (0, sitecore_api_1.pushRoleCommands)(root.environments[environmentName], commands, {
+        await (0, roles_1.pushRoleCommands)(root.environments[environmentName], commands, {
             timeoutMs: apiTimeoutMs,
         });
     }

package/dist/serialization/tasks/shared.d.ts

@@ -1,19 +1,12 @@
 /**
- * Helpers specific to `scai serialization` task runners — config and
- * module loading, subtree grouping by database, allowWrite check.
- * Neutral helpers (`toLogger`, `selectMatch`, `confirmDestructive`,
- * etc.) live in `@/shared/cli-tasks`; deploy-specific helpers
- * (`getDeployContext`, `extractDeployEnvironmentList`, etc.) live in
- * `@/deploy/tasks/shared`.
+ * `scai provision serialization` task-runner helpers.
+ *
+ * The substantive helpers — root config + serialization-module loading,
+ * subtree grouping, and the write-consent guard — moved to
+ * `@/serialization/context` (presentation-free, barrel-exported); this
+ * file re-exports them so the runners keep their `./shared` import
+ * surface. Neutral helpers (`toLogger`, `selectMatch`, etc.) live in
+ * `@/shared/cli-tasks`.
  */
-import { RootConfiguration, SerializationModuleConfiguration } from "../../config";
-import { FilesystemTreeSpec } from "../tree-spec";
-import type { CommonOptions } from "./types";
 export { toLogger, applyIfDefined, inputError, confirmDestructive, selectMatch, selectFromList, resolveApiTimeoutMs, } from "../../shared/cli-tasks";
-export declare const loadConfigAndModules: (options: CommonOptions) => Promise<{
-    root: RootConfiguration;
-    modules: SerializationModuleConfiguration[];
-}>;
-export declare const groupSubtreesByDatabase: (modules: SerializationModuleConfiguration[]) => Map<string, FilesystemTreeSpec[]>;
-export declare const ensureAllowWrite: (root: RootConfiguration, environmentName: string) => void;
-//# sourceMappingURL=shared.d.ts.map
+export { loadConfigAndModules, groupSubtreesByDatabase, ensureAllowWrite, type LoadSerializationModulesOptions, } from "../../serialization/context";

package/dist/serialization/tasks/shared.js

@@ -1,16 +1,16 @@
 "use strict";
 /**
- * Helpers specific to `scai serialization` task runners — config and
- * module loading, subtree grouping by database, allowWrite check.
- * Neutral helpers (`toLogger`, `selectMatch`, `confirmDestructive`,
- * etc.) live in `@/shared/cli-tasks`; deploy-specific helpers
- * (`getDeployContext`, `extractDeployEnvironmentList`, etc.) live in
- * `@/deploy/tasks/shared`.
+ * `scai provision serialization` task-runner helpers.
+ *
+ * The substantive helpers — root config + serialization-module loading,
+ * subtree grouping, and the write-consent guard — moved to
+ * `@/serialization/context` (presentation-free, barrel-exported); this
+ * file re-exports them so the runners keep their `./shared` import
+ * surface. Neutral helpers (`toLogger`, `selectMatch`, etc.) live in
+ * `@/shared/cli-tasks`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureAllowWrite = exports.groupSubtreesByDatabase = exports.loadConfigAndModules = exports.resolveApiTimeoutMs = exports.selectFromList = exports.selectMatch = exports.confirmDestructive = exports.inputError = exports.applyIfDefined = exports.toLogger = void 0;
-const config_1 = require("../../config");
-const errors_1 = require("../../shared/errors");
 // Re-exports preserve the existing barrel surface; new code should
 // import these directly from `@/shared/cli-tasks`.
 var cli_tasks_1 = require("../../shared/cli-tasks");
@@ -21,39 +21,9 @@ Object.defineProperty(exports, "confirmDestructive", { enumerable: true, get: fu
 Object.defineProperty(exports, "selectMatch", { enumerable: true, get: function () { return cli_tasks_1.selectMatch; } });
 Object.defineProperty(exports, "selectFromList", { enumerable: true, get: function () { return cli_tasks_1.selectFromList; } });
 Object.defineProperty(exports, "resolveApiTimeoutMs", { enumerable: true, get: function () { return cli_tasks_1.resolveApiTimeoutMs; } });
-const loadConfigAndModules = async (options) => {
-    const configPath = options.config ?? process.cwd();
-    const rootFile = (0, config_1.readRootConfigurationFile)(configPath);
-    const envName = options.environmentName ?? rootFile.config.defaultEnvProfile;
-    const root = (0, config_1.readRootConfiguration)(configPath, envName);
-    const modules = await (0, config_1.readSerializationModules)(root, options.include, options.exclude);
-    return { root, modules };
-};
-exports.loadConfigAndModules = loadConfigAndModules;
-const groupSubtreesByDatabase = (modules) => {
-    const map = new Map();
-    for (const module of modules) {
-        for (const subtree of module.items.includes) {
-            if (!map.has(subtree.database)) {
-                map.set(subtree.database, []);
-            }
-            map.get(subtree.database).push(subtree);
-        }
-    }
-    return map;
-};
-exports.groupSubtreesByDatabase = groupSubtreesByDatabase;
-const ensureAllowWrite = (root, environmentName) => {
-    const env = root.environments[environmentName];
-    if (!env?.allowWrite) {
-        const envKey = environmentName
-            .trim()
-            .toUpperCase()
-            .replace(/[^A-Z0-9]+/g, "_")
-            .replace(/^_+|_+$/g, "");
-        throw (0, errors_1.createCliError)(`Environment ${environmentName} is not configured to allow writing data.`, "INPUT_INVALID", {
-            hint: `Set allowWrite in sitecoreai.cli.json, set SITECOREAI_ENV_${envKey}_ALLOW_WRITE=true, or pass --allow-write.`,
-        });
-    }
-};
-exports.ensureAllowWrite = ensureAllowWrite;
+// The serialization context helpers, re-exported so the runners keep
+// their `./shared` import surface.
+var context_1 = require("../../serialization/context");
+Object.defineProperty(exports, "loadConfigAndModules", { enumerable: true, get: function () { return context_1.loadConfigAndModules; } });
+Object.defineProperty(exports, "groupSubtreesByDatabase", { enumerable: true, get: function () { return context_1.groupSubtreesByDatabase; } });
+Object.defineProperty(exports, "ensureAllowWrite", { enumerable: true, get: function () { return context_1.ensureAllowWrite; } });

package/dist/serialization/tasks/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Option types for `scai serialization` task runners (and the
+ * Option types for `scai provision serialization` task runners (and the
  * env-management tasks that share the serialization namespace —
  * `init`, `login`, `logout`, etc.). Deploy-specific option types
  * (`Deploy*Options`) live in `@/deploy/tasks/types`.
@@ -10,7 +10,45 @@ export type LogoutOptions = CommonOptions & {
     environmentName?: string;
     all?: boolean;
 };
-export type SyncOptions = CommonOptions & {
+/**
+ * Progress event emitted by runPull / runPush / runDiff per database
+ * iteration. External orchestrators (e.g. `scai mcp serve`) subscribe
+ * via `SyncOptions.emit` / `DiffOptions.emit` to forward live progress
+ * to a client.
+ */
+export type SerializationProgressEvent = {
+    kind: "database-start";
+    database: string;
+    subtreeCount: number;
+} | {
+    kind: "database-changes-detected";
+    database: string;
+    changes: number;
+} | {
+    kind: "database-applied";
+    database: string;
+    changes: number;
+    whatIf: boolean;
+} | {
+    kind: "database-skipped";
+    database: string;
+    reason: string;
+};
+export type SerializationProgressShape = {
+    /**
+     * Optional progress callback fired at major checkpoints inside the
+     * per-database loop. Pure side-channel — never load-bearing.
+     */
+    emit?: (event: SerializationProgressEvent) => void;
+    /**
+     * Cooperative cancellation. When the signal fires, the task stops
+     * between databases (in-flight requests are not interrupted) and
+     * returns. Partial filesystem / tenant state is left in place — the
+     * task is best-effort cancellable, like `deploy_run_cancel`.
+     */
+    signal?: AbortSignal;
+};
+export type SyncOptions = CommonOptions & SerializationProgressShape & {
     environmentName?: string;
     whatIf?: boolean;
     force?: boolean;
@@ -20,10 +58,13 @@ export type SyncOptions = CommonOptions & {
     targets?: string[];
     useDebugSignatures?: boolean;
 };
-export type DiffOptions = CommonOptions & {
+export type DiffOptions = CommonOptions & SerializationProgressShape & {
     source: string;
     destination: string;
     push?: boolean;
+    whatIf?: boolean;
+    allowWrite?: boolean;
+    force?: boolean;
     path?: string;
     sourceDatabase?: string;
     destinationDatabase?: string;
@@ -70,4 +111,3 @@ export type ConnectOptions = CommonOptions & {
     setDefault?: boolean;
     wizard?: boolean;
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/serialization/tasks/types.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Option types for `scai serialization` task runners (and the
+ * Option types for `scai provision serialization` task runners (and the
  * env-management tasks that share the serialization namespace —
  * `init`, `login`, `logout`, etc.). Deploy-specific option types
  * (`Deploy*Options`) live in `@/deploy/tasks/types`.

package/dist/serialization/tasks/users.d.ts

@@ -1,5 +1,5 @@
-import { readRootConfiguration, SerializationModuleConfiguration } from "../../config";
+import { readRootConfiguration } from "../../config/root-config";
+import type { SerializationModuleConfiguration } from "../../config/types";
 import { Logger } from "../../shared/logger";
 export declare const syncUsersPull: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
 export declare const syncUsersPush: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
-//# sourceMappingURL=users.d.ts.map