@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.1

package/dist/serialization/tasks/env/status.js

@@ -1,26 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runStatus = void 0;
-const config_1 = require("../../../config");
+const root_config_1 = require("../../../config/root-config");
 const keychain_1 = require("../../../shared/keychain");
+const credential_matrix_1 = require("../../../shared/credential-matrix");
 const shared_1 = require("../shared");
+/**
+ * Resolve the deploy token's freshness metadata. Per `docs/credentials.md`
+ * the config file holds every token's non-secret metadata: the
+ * `deployTokenExpiresIn` / `deployTokenLastUpdated` fields live on the
+ * env profile.
+ */
+const resolveDeployTokenMeta = (env) => ({
+    expiresIn: env.deployTokenExpiresIn ?? null,
+    lastUpdated: env.deployTokenLastUpdated ?? null,
+});
 const runStatus = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     const configPath = options.config ?? process.cwd();
-    const rootConfigFile = (0, config_1.readRootConfigurationFile)(configPath);
+    const rootConfigFile = (0, root_config_1.readRootConfigurationFile)(configPath);
     const defaultName = rootConfigFile.config.defaultEnvProfile;
-    const root = (0, config_1.readRootConfiguration)(configPath, defaultName);
+    const root = (0, root_config_1.readRootConfiguration)(configPath, defaultName);
     const envProfiles = rootConfigFile.config.envProfiles ?? {};
     const reservedName = "default";
     const names = Object.keys(envProfiles)
         .filter((name) => name !== reservedName)
         .sort((a, b) => a.localeCompare(b));
+    /** Resolve the credential matrix (env client / org client / brand) for one environment. */
+    const resolveCredentials = (name, env) => {
+        const orgId = env.organizationId;
+        return (0, credential_matrix_1.resolveCredentialMatrix)(name, env, Boolean(orgId && root.brand?.[orgId]), Boolean(orgId && root.orgClients?.[orgId]?.clientId));
+    };
     if (logger.isJson()) {
         const results = [];
         for (const name of names) {
             const env = root.environments[name] ?? envProfiles[name];
             const cachedCmTokens = env.cacheAuthenticationToken === false ? undefined : await (0, keychain_1.getCmTokens)(name);
             const deployToken = (await (0, keychain_1.getDeployToken)(name)) ?? env.deployToken;
+            const deployTokenMeta = resolveDeployTokenMeta(env);
+            const credentials = await resolveCredentials(name, env);
             results.push({
                 name,
                 isDefault: name === defaultName,
@@ -36,7 +54,7 @@ const runStatus = async (options) => {
                 },
                 editingHostEnvironmentIds: env.editingHostEnvironmentIds ?? [],
                 cmAuth: env.useClientCredentials
-                    ? env.clientId && env.clientSecret
+                    ? credentials.envClient || credentials.orgClient
                         ? "client-credentials"
                         : "client-credentials (incomplete)"
                     : cachedCmTokens?.accessToken || cachedCmTokens?.refreshToken
@@ -48,8 +66,9 @@ const runStatus = async (options) => {
                                 : "missing",
                 deployToken: Boolean(deployToken),
                 allowWrite: Boolean(env.allowWrite),
-                deployTokenExpiresIn: env.deployTokenExpiresIn ?? null,
-                deployTokenLastUpdated: env.deployTokenLastUpdated ?? null,
+                deployTokenExpiresIn: deployTokenMeta.expiresIn,
+                deployTokenLastUpdated: deployTokenMeta.lastUpdated,
+                credentials,
             });
         }
         logger.json({
@@ -77,6 +96,7 @@ const runStatus = async (options) => {
         const cachedCmTokens = env.cacheAuthenticationToken === false ? undefined : await (0, keychain_1.getCmTokens)(name);
         const hasCachedCmTokens = Boolean(cachedCmTokens?.accessToken || cachedCmTokens?.refreshToken);
         const deployToken = (await (0, keychain_1.getDeployToken)(name)) ?? env.deployToken;
+        const credentials = await resolveCredentials(name, env);
         const hasConfig = Boolean(env.host ||
             env.authority ||
             env.ref ||
@@ -86,13 +106,12 @@ const runStatus = async (options) => {
             env.environmentId ||
             env.deployToken ||
             env.clientId ||
-            env.clientSecret ||
             env.audience ||
             env.useClientCredentials !== undefined ||
             env.allowWrite !== undefined ||
             (env.variables && Object.keys(env.variables).length > 0));
         const cmAuth = env.useClientCredentials
-            ? env.clientId && env.clientSecret
+            ? credentials.envClient || credentials.orgClient
                 ? "client-credentials"
                 : "client-credentials (incomplete)"
             : hasCachedCmTokens
@@ -133,10 +152,11 @@ const runStatus = async (options) => {
         }
         logger.info(`  cmAuth: ${cmAuth}`);
         logger.info(`  deployToken: ${hasDeployToken ? "set" : "missing"}`);
-        if (env.deployTokenExpiresIn && env.deployTokenLastUpdated) {
-            const last = Date.parse(env.deployTokenLastUpdated);
+        const deployTokenMeta = resolveDeployTokenMeta(env);
+        if (deployTokenMeta.expiresIn && deployTokenMeta.lastUpdated) {
+            const last = Date.parse(deployTokenMeta.lastUpdated);
             if (!Number.isNaN(last)) {
-                const expiresAt = last + env.deployTokenExpiresIn * 1000;
+                const expiresAt = last + deployTokenMeta.expiresIn * 1000;
                 const msRemaining = expiresAt - Date.now();
                 if (msRemaining <= 10 * 60 * 1000) {
                     logger.warn("  deployToken: expiring soon", "yellow");
@@ -144,6 +164,11 @@ const runStatus = async (options) => {
             }
         }
         logger.info(`  allowWrite: ${env.allowWrite ? "true" : "false"}`);
+        const mark = (present) => (present ? "ok" : "missing");
+        logger.info("  credentials:");
+        logger.info(`    env client: ${mark(credentials.envClient)}`);
+        logger.info(`    org client: ${mark(credentials.orgClient)}`);
+        logger.info(`    brand:      ${mark(credentials.brand)}`);
     }
 };
 exports.runStatus = runStatus;

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

@@ -1,8 +1,7 @@
-import { readRootConfiguration } from "../../../config";
+import { readRootConfiguration } from "../../../config/root-config";
 import { FilesystemTreeSpec } from "../../tree-spec";
 import { ItemData, ItemMetadata } from "../../types";
 export declare const collectItemData: (environmentName: string, root: ReturnType<typeof readRootConfiguration>, subtrees: FilesystemTreeSpec[], useDebugSignatures: boolean) => Promise<{
     items: ItemData[];
     metadata: ItemMetadata[];
 }>;
-//# sourceMappingURL=collect.d.ts.map

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

@@ -2,28 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectItemData = void 0;
 const field_filter_1 = require("../../field-filter");
-const sitecore_api_1 = require("../../sitecore-api");
+const items_1 = require("../../api/items");
 const shared_1 = require("../shared");
 const errors_1 = require("../../../shared/errors");
+const concurrency_1 = require("../../../shared/concurrency");
 const collectItemData = async (environmentName, root, subtrees, useDebugSignatures) => {
     const env = root.environments[environmentName];
     if (!env) {
-        throw (0, errors_1.createCliError)(`Environment ${environmentName} was not defined.`, "ENV_NOT_FOUND");
+        throw (0, errors_1.createScaiError)(`Environment ${environmentName} was not defined.`, "ENV_NOT_FOUND");
     }
     const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
-    const items = [];
-    const metadata = [];
-    for (const subtree of subtrees) {
-        const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
-        const subtreeMetadata = await (0, sitecore_api_1.fetchItemMetadata)(env, subtree.database, subtree.path.toPathString(), subtree.scope, filter, useDebugSignatures, { timeoutMs: apiTimeoutMs });
-        const filtered = subtreeMetadata.filter((item) => subtree.includesPath(item.path));
-        metadata.push(...filtered);
-    }
-    for (const meta of metadata) {
-        const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
-        const itemData = await (0, sitecore_api_1.fetchItemData)(env, meta.database ?? "master", meta.id, "SingleItem", filter, { timeoutMs: apiTimeoutMs });
-        items.push(...itemData);
-    }
+    // Hoist filter creation: `excludedFields` is invariant across this call,
+    // so the same filter instance is safe to share across every fetch.
+    const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
+    // Subtree metadata fetches are independent — run concurrently with a
+    // bounded fan-out. Result ordering is preserved by mapWithConcurrency,
+    // matching the previous sequential behaviour.
+    const perSubtreeMetadata = await (0, concurrency_1.mapWithConcurrency)(subtrees, async (subtree) => {
+        const subtreeMetadata = await (0, items_1.fetchItemMetadata)(env, subtree.database, subtree.path.toPathString(), subtree.scope, filter, useDebugSignatures, { timeoutMs: apiTimeoutMs });
+        return subtreeMetadata.filter((item) => subtree.includesPath(item.path));
+    });
+    const metadata = perSubtreeMetadata.flat();
+    // Item-body fetches were sequential — the biggest perf hit in the
+    // diff/push/pull path. For N items at ~100 ms each, sequential was N *
+    // 100 ms; parallel with concurrency 8 is roughly N/8 * 100 ms. Order
+    // preserved so downstream callers see the same shape they always did.
+    const perItemData = await (0, concurrency_1.mapWithConcurrency)(metadata, async (meta) => (0, items_1.fetchItemData)(env, meta.database ?? "master", meta.id, "SingleItem", filter, {
+        timeoutMs: apiTimeoutMs,
+    }));
+    const items = perItemData.flat();
     return { items, metadata };
 };
 exports.collectItemData = collectItemData;

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

@@ -2,4 +2,3 @@ import { FilesystemTreeSpec } from "../../tree-spec";
 import { ItemMetadata } from "../../types";
 import { ItemCommand } from "../../commands";
 export declare const buildCommandsForDatabase: (subtrees: FilesystemTreeSpec[], sourceMetadata: ItemMetadata[], destinationMetadata: ItemMetadata[], applyAllowedPushOperations: boolean) => ItemCommand[];
-//# sourceMappingURL=commands.d.ts.map

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

@@ -3,4 +3,3 @@ import { ItemData } from "../../types";
 import { Logger } from "../../../shared/logger";
 import { ItemCommand } from "../../commands";
 export declare const applyFilesystemCommands: (commands: ItemCommand[], pathProvider: FilesystemPathProvider, sourceData: Map<string, ItemData>, logger: Logger) => Promise<string[]>;
-//# sourceMappingURL=filesystem.d.ts.map

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";