@sitecoreai-labs/sitecoreai-cli 0.0.4

package/dist/commands/deploy/source-control.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeploySourceControlCommand = void 0;
+const commander_1 = require("commander");
+const tasks_1 = require("../../deploy/tasks");
+const shared_1 = require("./shared");
+const createDeploySourceControlCommand = () => {
+    const sourceControl = new commander_1.Command("source-control")
+        .description("Source control operations")
+        .alias("sc");
+    const sourceControlList = new commander_1.Command("list").description("List source control integrations");
+    (0, shared_1.addDeployBaseOptions)(sourceControlList);
+    sourceControlList.action(async (options) => (0, tasks_1.runDeploySourceControlList)(options));
+    const sourceControlState = new commander_1.Command("state").description("Get OAuth state for integration");
+    (0, shared_1.addDeployBaseOptions)(sourceControlState);
+    sourceControlState.action(async (options) => (0, tasks_1.runDeploySourceControlState)(options));
+    const sourceControlAccessToken = new commander_1.Command("access-token").description("Get source control integration access token");
+    (0, shared_1.addDeployBaseOptions)(sourceControlAccessToken);
+    sourceControlAccessToken.addOption(new commander_1.Option("--id <id>", "Integration ID"));
+    sourceControlAccessToken.action(async (options) => (0, tasks_1.runDeploySourceControlAccessToken)(options));
+    const sourceControlValidate = new commander_1.Command("validate").description("Validate source control integration");
+    (0, shared_1.addDeployBaseOptions)(sourceControlValidate);
+    sourceControlValidate.addOption(new commander_1.Option("--id <id>", "Integration ID"));
+    sourceControlValidate.action(async (options) => (0, tasks_1.runDeploySourceControlValidate)(options));
+    const sourceControlRepository = new commander_1.Command("repository").description("Source control repository operations");
+    const sourceControlRepositoryGet = new commander_1.Command("get").description("Get source control repository");
+    (0, shared_1.addDeployBaseOptions)(sourceControlRepositoryGet);
+    sourceControlRepositoryGet
+        .addOption(new commander_1.Option("--integration-id <id>", "Integration ID"))
+        .addOption(new commander_1.Option("--repository-id <id>", "Repository ID"));
+    sourceControlRepositoryGet.action(async (options) => (0, tasks_1.runDeploySourceControlRepositoryGet)(options));
+    const sourceControlRepositoryBranches = new commander_1.Command("branches").description("List repository branches");
+    (0, shared_1.addDeployBaseOptions)(sourceControlRepositoryBranches);
+    sourceControlRepositoryBranches
+        .addOption(new commander_1.Option("--repository-name <name>", "Repository name"))
+        .addOption(new commander_1.Option("--integration-id <id>", "Integration ID"));
+    sourceControlRepositoryBranches.action(async (options) => (0, tasks_1.runDeploySourceControlRepositoryBranches)(options));
+    const sourceControlRepositoryValidate = new commander_1.Command("validate").description("Validate source control repository");
+    (0, shared_1.addDeployBaseOptions)(sourceControlRepositoryValidate);
+    sourceControlRepositoryValidate
+        .addOption(new commander_1.Option("--integration-id <id>", "Integration ID"))
+        .addOption(new commander_1.Option("--repository-name <name>", "Repository name"));
+    sourceControlRepositoryValidate.action(async (options) => (0, tasks_1.runDeploySourceControlRepositoryValidate)(options));
+    const sourceControlRepositoryCreateFromTemplate = new commander_1.Command("create-from-template").description("Create repository from template");
+    (0, shared_1.addDeployBaseOptions)(sourceControlRepositoryCreateFromTemplate);
+    sourceControlRepositoryCreateFromTemplate
+        .addOption(new commander_1.Option("--provider <name>", "Provider (ado or github)"))
+        .addOption(new commander_1.Option("--template-repository <name>", "Template repository name"))
+        .addOption(new commander_1.Option("--template-owner <name>", "Template repository owner"))
+        .addOption(new commander_1.Option("--repository-name <name>", "Repository name"))
+        .addOption(new commander_1.Option("--owner <name>", "Repository owner"))
+        .addOption(new commander_1.Option("--integration-id <id>", "Integration ID"))
+        .addOption(new commander_1.Option("--description <text>", "Repository description"))
+        .addOption(new commander_1.Option("--private-repository", "Create a private repository"))
+        .addOption(new commander_1.Option("--no-private-repository", "Create a public repository"))
+        .addOption(new commander_1.Option("--include-all-branches", "Include all branches from template"))
+        .addOption(new commander_1.Option("--no-include-all-branches", "Exclude non-default branches"));
+    sourceControlRepositoryCreateFromTemplate.action(async (options) => (0, tasks_1.runDeploySourceControlRepositoryCreateFromTemplate)(options));
+    sourceControlRepository.addCommand(sourceControlRepositoryBranches);
+    sourceControlRepository.addCommand(sourceControlRepositoryCreateFromTemplate);
+    sourceControlRepository.addCommand(sourceControlRepositoryGet);
+    sourceControlRepository.addCommand(sourceControlRepositoryValidate);
+    const sourceControlProviders = new commander_1.Command("providers").description("List source control providers");
+    (0, shared_1.addDeployBaseOptions)(sourceControlProviders);
+    sourceControlProviders.action(async (options) => (0, tasks_1.runDeploySourceControlProviders)(options));
+    const sourceControlTemplates = new commander_1.Command("templates").description("List source control templates");
+    (0, shared_1.addDeployBaseOptions)(sourceControlTemplates);
+    sourceControlTemplates.addOption(new commander_1.Option("--provider <name>", "Provider (ado or github)"));
+    sourceControlTemplates.action(async (options) => (0, tasks_1.runDeploySourceControlTemplates)(options));
+    const sourceControlGet = new commander_1.Command("get").description("Get a source control integration");
+    (0, shared_1.addDeployBaseOptions)(sourceControlGet);
+    sourceControlGet.addOption(new commander_1.Option("--id <id>", "Integration ID"));
+    sourceControlGet.action(async (options) => (0, tasks_1.runDeploySourceControlGet)(options));
+    const sourceControlDelete = new commander_1.Command("delete").description("Delete a source control integration");
+    (0, shared_1.addDeployBaseOptions)(sourceControlDelete);
+    sourceControlDelete.addOption(new commander_1.Option("--id <id>", "Integration ID"));
+    sourceControlDelete.action(async (options) => (0, tasks_1.runDeploySourceControlDelete)(options));
+    sourceControl.addCommand(sourceControlAccessToken);
+    sourceControl.addCommand(sourceControlDelete);
+    sourceControl.addCommand(sourceControlGet);
+    sourceControl.addCommand(sourceControlList);
+    sourceControl.addCommand(sourceControlProviders);
+    sourceControl.addCommand(sourceControlRepository);
+    sourceControl.addCommand(sourceControlState);
+    sourceControl.addCommand(sourceControlTemplates);
+    sourceControl.addCommand(sourceControlValidate);
+    return sourceControl;
+};
+exports.createDeploySourceControlCommand = createDeploySourceControlCommand;

package/dist/commands/deploy.d.ts

@@ -0,0 +1,2 @@
+export { createDeployCommand } from "./deploy/index";
+//# sourceMappingURL=deploy.d.ts.map

package/dist/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/deploy.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeployCommand = void 0;
+var index_1 = require("./deploy/index");
+Object.defineProperty(exports, "createDeployCommand", { enumerable: true, get: function () { return index_1.createDeployCommand; } });

package/dist/commands/history.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createHistoryCommand: () => Command;
+//# sourceMappingURL=history.d.ts.map

package/dist/commands/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAoC5C,eAAO,MAAM,oBAAoB,QAAO,OA4EvC,CAAC"}

package/dist/commands/history.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHistoryCommand = void 0;
+const commander_1 = require("commander");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const logger_1 = require("../shared/logger");
+const history_1 = require("../shared/history");
+const shared_1 = require("./shared");
+const formatEntry = (value) => {
+    if (!value || typeof value !== "object") {
+        return String(value ?? "");
+    }
+    const entry = value;
+    const timestamp = entry.timestamp ?? "";
+    const event = entry.event ?? "unknown";
+    const command = entry.command ?? "(unknown)";
+    const suffix = entry.error ? ` - ${entry.error}` : "";
+    return `${timestamp} [${event}] ${command}${suffix}`.trim();
+};
+const createHistoryCommand = () => {
+    const command = new commander_1.Command("history").description("Show CLI activity history");
+    command
+        .addOption(new commander_1.Option("--path <path>", "History log path override"))
+        .addOption(new commander_1.Option("--limit <number>", "Number of entries to show").argParser(Number))
+        .addOption(new commander_1.Option("--raw", "Print raw JSON lines"))
+        .addOption(new commander_1.Option("--reverse", "Show newest entries first"))
+        .addOption(new commander_1.Option("--show-path", "Show the history log path and exit"));
+    (0, shared_1.addVerbosityOptions)(command);
+    command.addHelpText("after", "\nExamples:\n  $ scai history --limit 20\n  $ scai history --show-path\n");
+    command.action(async (options) => {
+        const logger = new logger_1.Logger(Boolean(options.verbose), Boolean(options.trace), Boolean(options.json), Boolean(options.quiet), options.logFile);
+        const filePath = options.path ?? (0, history_1.getHistoryPath)();
+        if (options.showPath) {
+            if (logger.isJson()) {
+                logger.json({ path: filePath });
+            }
+            else {
+                logger.info(filePath);
+            }
+            return;
+        }
+        const limit = options.limit ?? 50;
+        try {
+            const content = await promises_1.default.readFile(filePath, "utf8");
+            const lines = content.split("\n").filter((line) => line.trim().length > 0);
+            const selected = limit > 0 ? lines.slice(-limit) : lines;
+            const output = options.reverse ? selected.reverse() : selected;
+            if (logger.isJson()) {
+                const parsed = output.map((line) => {
+                    try {
+                        return JSON.parse(line);
+                    }
+                    catch {
+                        return { raw: line };
+                    }
+                });
+                logger.json(parsed);
+                return;
+            }
+            for (const line of output) {
+                if (options.raw) {
+                    logger.info(line);
+                    continue;
+                }
+                try {
+                    logger.info(formatEntry(JSON.parse(line)));
+                }
+                catch {
+                    logger.info(line);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                logger.warn(`No history file found at ${filePath}.`);
+                return;
+            }
+            throw error;
+        }
+    });
+    return command;
+};
+exports.createHistoryCommand = createHistoryCommand;

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createInitCommand: () => Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,eAAO,MAAM,iBAAiB,QAAO,OA2CpC,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInitCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const tasks_1 = require("../serialization/tasks");
+const createInitCommand = () => {
+    const command = new commander_1.Command("init").description("Create or update an environment with project selection and SitecoreAI credentials");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--cm, --host <url>", "Sitecore CM host (base URL)"))
+        .addOption(new commander_1.Option("--ref <name>", "Reference an existing environment for auth"))
+        .addOption(new commander_1.Option("--allow-write", "Allow write operations for this environment"))
+        .addOption(new commander_1.Option("--wizard", "Run the interactive setup wizard"))
+        .addOption(new commander_1.Option("--skip-deploy-lookup", "Skip Deploy API lookups and prompt for the CM host directly"))
+        .addOption(new commander_1.Option("--organization-id <id>", "Sitecore organization ID"))
+        .addOption(new commander_1.Option("--tenant-id <id>", "Sitecore tenant ID"))
+        .addOption(new commander_1.Option("--organization <name>", "Organization name or ID (Deploy API)"))
+        .addOption(new commander_1.Option("--project <value>", "Project name or ID (Deploy API)"))
+        .addOption(new commander_1.Option("--environment <value>", "Environment name or ID (Deploy API)"))
+        .addOption(new commander_1.Option("--deploy-token <token>", "SitecoreAI access token (Deploy + CM/admin scopes)"))
+        .addOption(new commander_1.Option("--client-id <id>", "SitecoreAI client ID"))
+        .addOption(new commander_1.Option("--client-secret <secret>", "SitecoreAI client secret"))
+        .addOption(new commander_1.Option("--use-client-credentials", "Use client credentials instead of interactive login"))
+        .addOption(new commander_1.Option("--set-default", "Set as default environment"));
+    command.addHelpText("after", '\nExamples:\n  $ scai init --wizard\n  $ scai init -n demo --project "My Project" --environment "Dev"\n');
+    command.action(async (options) => (0, tasks_1.runInit)(options));
+    return command;
+};
+exports.createInitCommand = createInitCommand;

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createLoginCommand: () => Command;
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,eAAO,MAAM,kBAAkB,QAAO,OAyBrC,CAAC"}

package/dist/commands/login.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoginCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const tasks_1 = require("../serialization/tasks");
+const createLoginCommand = () => {
+    const command = new commander_1.Command("login").description("Authenticate with SitecoreAI and store an access token (Deploy + CM/admin scopes)");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--client-id <id>", "SitecoreAI client ID"))
+        .addOption(new commander_1.Option("--client-secret <secret>", "SitecoreAI client secret"))
+        .addOption(new commander_1.Option("--use-client-credentials", "Use client credentials instead of interactive login"))
+        .addOption(new commander_1.Option("--print", "Print the access token to stdout"));
+    command.addHelpText("after", "\nExamples:\n  $ scai login -n demo\n  $ scai login -n demo --use-client-credentials\n");
+    command.action(async (options) => (0, tasks_1.runDeployToken)(options));
+    return command;
+};
+exports.createLoginCommand = createLoginCommand;

package/dist/commands/logout.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createLogoutCommand: () => Command;
+//# sourceMappingURL=logout.d.ts.map

package/dist/commands/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,eAAO,MAAM,mBAAmB,QAAO,OActC,CAAC"}

package/dist/commands/logout.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogoutCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const tasks_1 = require("../serialization/tasks");
+const createLogoutCommand = () => {
+    const command = new commander_1.Command("logout").description("Clear stored authentication tokens");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--all", "Clear tokens for all environments"))
+        .action(async (options) => (0, tasks_1.runLogout)(options));
+    command.addHelpText("after", "\nExamples:\n  $ scai logout -n demo\n  $ scai logout --all\n");
+    return command;
+};
+exports.createLogoutCommand = createLogoutCommand;

package/dist/commands/recipe/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createRecipeCommand: () => Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/recipe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/recipe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAmP5C,eAAO,MAAM,mBAAmB,QAAO,OA2CtC,CAAC"}

package/dist/commands/recipe/index.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRecipeCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("../shared");
+const tasks_1 = require("../../recipe/tasks");
+const errors_1 = require("../../shared/errors");
+const addOptionalInputOption = (command, label) => command.addOption(new commander_1.Option("-i, --input <path>", `${label}. Defaults to the config \`recipes\` glob from sitecoreai.cli.json.`));
+const addRequiredInputOption = (command, label) => command.addOption(new commander_1.Option("-i, --input <path>", label).makeOptionMandatory(true));
+const addOutputOption = (command) => command.addOption(new commander_1.Option("-o, --output <path>", "Path to write the output file"));
+// All flags are optional. Each falls back to the matching field on
+// envProfiles[<name>] in sitecoreai.cli.json. resolveRecipeRoots() throws
+// `INPUT_INVALID` for the two required ones (templatesRoot, renderingsRoot)
+// when neither source is set; the Phase 4 composition roots are optional
+// and only surface errors when their corresponding recipe kinds are
+// being compiled.
+const addRecipeRootOptions = (command) => command
+    .addOption(new commander_1.Option("--templates-root <path>", "Sitecore parent path for template items. Falls back to envProfiles[<name>].templatesRoot."))
+    .addOption(new commander_1.Option("--renderings-root <path>", "Sitecore parent path for rendering items. Falls back to envProfiles[<name>].renderingsRoot."))
+    .addOption(new commander_1.Option("--components-root <path>", "Sitecore parent path for component template items in the per-site folder layout (Phase 2). Falls back to envProfiles[<name>].componentsRoot."))
+    .addOption(new commander_1.Option("--content-models-root <path>", "Sitecore parent path for content-template items (Phase 2). Falls back to envProfiles[<name>].contentModelsRoot."))
+    .addOption(new commander_1.Option("--partial-designs-root <path>", "Sitecore parent path for partial-design items (Phase 4). Falls back to envProfiles[<name>].partialDesignsRoot."))
+    .addOption(new commander_1.Option("--page-designs-root <path>", "Sitecore parent path for page-design items (Phase 4). Falls back to envProfiles[<name>].pageDesignsRoot."))
+    .addOption(new commander_1.Option("--content-items-root <path>", "Sitecore parent path for shared content items (Phase 4). Falls back to envProfiles[<name>].contentItemsRoot."));
+const createCompileCommand = () => {
+    const command = new commander_1.Command("compile").description("Compile recipe (.ts/.json) files to Operation IR JSON files");
+    addOptionalInputOption(command, "Path to a recipe file");
+    addOutputOption(command);
+    addRecipeRootOptions(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runRecipeCompile)(options));
+    return command;
+};
+const createPlanCommand = () => {
+    const command = new commander_1.Command("plan").description("Plan an Operation IR push against a tenant — read-then-diff, no mutations");
+    addRequiredInputOption(command, "Path to a compiled .ir.json file");
+    addOutputOption(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        await (0, tasks_1.runRecipePlan)(options);
+    });
+    return command;
+};
+const createDiffCommand = () => {
+    const command = new commander_1.Command("diff").description("Show what `recipe push` would change — read-only diff against a tenant. Compiles recipes in-memory; never mutates.");
+    addOptionalInputOption(command, "Path to a recipe file (.recipe.ts/.json) or pre-compiled .ir.json");
+    addRecipeRootOptions(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        await (0, tasks_1.runRecipeDiff)(options);
+    });
+    return command;
+};
+const createPushCommand = () => {
+    const command = new commander_1.Command("push").description("Apply recipes to a tenant. Compiles in-memory and runs the executor with idempotency + best-effort rollback.");
+    addOptionalInputOption(command, "Path to a recipe file (.recipe.ts/.json) or pre-compiled .ir.json");
+    addRecipeRootOptions(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addAllowWriteOption)(command);
+    command.addOption(new commander_1.Option("--skip-unchanged-recipes", "Skip recipes whose compiled IR digest matches the cached entry from the previous successful push (.scai/recipe-cache.json). Off by default — opt in for fast re-pushes of an unchanged recipe set."));
+    command.addOption(new commander_1.Option("--plan-concurrency <n>", "Number of recipes plan-mode (--what-if) runs concurrently. Defaults to 4. Apply mode is always sequential per-recipe.").argParser((value) => {
+        const parsed = Number.parseInt(value, 10);
+        if (!Number.isFinite(parsed) || parsed < 1) {
+            throw new Error("--plan-concurrency must be a positive integer.");
+        }
+        return parsed;
+    }));
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        const results = await (0, tasks_1.runRecipePush)(options);
+        // Surface failure to the caller's exit code. `runRecipePush` returns
+        // a non-empty array even when every recipe aborted with errors —
+        // without this guard, the CLI exits 0 and orchestrators (or CI)
+        // can't tell a successful push from a 100%-failed one.
+        const failed = results.some((result) => result.aborted || result.summary.error > 0);
+        if (failed) {
+            const abortedRecipes = results.filter((r) => r.aborted);
+            const errored = results.reduce((acc, r) => acc + r.summary.error, 0);
+            // Pull each aborted recipe's last action's reason / rollback summary
+            // so the top-level error message names which recipes failed and (if
+            // the action's reason is set) why. Truncated event logs in
+            // orchestrator stdout often hide the apply-error events; surfacing
+            // it here makes diagnosis cheap.
+            const abortDetails = abortedRecipes.map((r) => {
+                const lastAction = r.plan.actions[r.plan.actions.length - 1];
+                const rollback = r.rollback
+                    ? ` rolled back ${r.rollback.rolledBack} of ${r.plan.actions.filter((a) => a.mutation).length} applied`
+                    : "";
+                return `${r.plan.recipeHandle}: ${lastAction?.operation.label ?? "(unknown op)"} — ${lastAction?.reason ?? "apply error (see events[])"}${rollback}`;
+            });
+            throw (0, errors_1.createCliError)(`Recipe push failed: ${abortedRecipes.length} of ${results.length} recipe(s) aborted; ${errored} op error(s) total.`, "DEPLOY_FAILED", {
+                hint: "Inspect per-op `events[]` in the JSON output (or rerun with --verbose) to see which op aborted and why.",
+                details: abortDetails,
+            });
+        }
+    });
+    return command;
+};
+const createPruneDefaultsCommand = () => {
+    const command = new commander_1.Command("prune-defaults").description("Remove the SXA Headless OOTB child folders under Available Renderings (Media, Navigation, Page Content, Page Structure), Headless Variants (Image, LinkList, Navigation, Page Content, Promo, Rich Text, Title), and Data (Images, Link Lists, Navigation Filters, Promos, Texts — Tags is preserved). Keeps the parent folders. Idempotent — missing items are skipped, not errored.");
+    command.addOption(new commander_1.Option("--headless-variants-root <path>", "Override headlessVariantsRoot from the env profile (e.g. /sitecore/content/<col>/<site>/Presentation/Headless Variants)."));
+    command.addOption(new commander_1.Option("--available-renderings-root <path>", "Override availableRenderingsRoot from the env profile (e.g. /sitecore/content/<col>/<site>/Presentation/Available Renderings)."));
+    command.addOption(new commander_1.Option("--content-items-root <path>", "Override contentItemsRoot from the env profile (e.g. /sitecore/content/<col>/<site>/Data)."));
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addAllowWriteOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        await (0, tasks_1.runRecipePruneDefaults)(options);
+    });
+    return command;
+};
+const createRecipeCommand = () => {
+    const command = new commander_1.Command("recipe").description("Compile, plan, and push declarative recipes to Sitecore");
+    command.addCommand(createCompileCommand());
+    command.addCommand(createDiffCommand());
+    command.addCommand(createPlanCommand());
+    command.addCommand(createPushCommand());
+    command.addCommand(createPruneDefaultsCommand());
+    command.addHelpText("after", [
+        "",
+        "Examples:",
+        "  # Compile a single recipe to IR",
+        "  $ scai recipe compile -i ./recipes/cta-button.recipe.ts \\",
+        '      --templates-root "/sitecore/templates/Project/my-site/Components" \\',
+        '      --renderings-root "/sitecore/layout/Renderings/Project/my-site"',
+        "",
+        "  # Plan against a tenant from a pre-compiled IR",
+        "  $ scai recipe plan -i ./recipes/.scai/cta-button_v1.ir.json -n my-tenant",
+        "",
+        "  # Diff every recipe in the config glob against a tenant (read-only)",
+        "  $ scai recipe diff -n my-tenant",
+        "",
+        "  # Push every recipe in the config glob (default `recipes/**/*.recipe.ts`)",
+        "  $ scai recipe push -n my-tenant --what-if",
+        "  $ scai recipe push -n my-tenant --allow-write",
+        "",
+        "  # Push a single recipe explicitly",
+        "  $ scai recipe push -i ./recipes/cta-button.recipe.ts -n my-tenant --allow-write",
+        "",
+        "  # Preview the SXA OOTB prune (no mutations)",
+        "  $ scai recipe prune-defaults -n my-tenant --what-if",
+        "",
+        "  # Apply the SXA OOTB prune",
+        "  $ scai recipe prune-defaults -n my-tenant --allow-write",
+    ].join("\n"));
+    return command;
+};
+exports.createRecipeCommand = createRecipeCommand;

package/dist/commands/serialization/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createSerializationCommand: () => Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/serialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8HpC,eAAO,MAAM,0BAA0B,QAAO,OAoB7C,CAAC"}

package/dist/commands/serialization/index.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSerializationCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("../shared");
+const package_1 = require("./package");
+const tasks_1 = require("../../serialization/tasks");
+const createInfoCommand = () => {
+    const command = new commander_1.Command("info").description("Shows serialization configuration information");
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runInfo)(options));
+    return command;
+};
+const createExplainCommand = () => {
+    const command = new commander_1.Command("explain").description("Explains whether an item path is included and why");
+    (0, shared_1.addExplainOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runExplain)(options));
+    return command;
+};
+const createPullCommand = () => {
+    const command = new commander_1.Command("pull").description("Pulls serialized items from Sitecore to disk");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addForceOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runPull)(options));
+    return command;
+};
+const createPushCommand = () => {
+    const command = new commander_1.Command("push").description("Pushes serialized items from disk into Sitecore");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addForceOption)(command);
+    (0, shared_1.addAllowWriteOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runPush)(options));
+    return command;
+};
+const createDiffCommand = () => {
+    const command = new commander_1.Command("diff").description("Compares two Sitecore instances");
+    (0, shared_1.addDiffOptions)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runDiff)(options));
+    return command;
+};
+const createValidateCommand = () => {
+    const command = new commander_1.Command("validate").description("Checks serialized items for validity and can fix common issues");
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addValidateOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runValidate)(options));
+    return command;
+};
+const createWatchCommand = () => {
+    const command = new commander_1.Command("watch").description("Watches item changes in Sitecore and pulls them to disk");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runWatch)(options));
+    return command;
+};
+const createSerializationCommand = () => {
+    const command = new commander_1.Command("serialization")
+        .description("Item serialization commands")
+        .alias("ser");
+    command.addCommand(createDiffCommand());
+    command.addCommand(createExplainCommand());
+    command.addCommand(createInfoCommand());
+    command.addCommand((0, package_1.createPackageCommand)());
+    command.addCommand(createPullCommand());
+    command.addCommand(createPushCommand());
+    command.addCommand(createValidateCommand());
+    command.addCommand(createWatchCommand());
+    command.addHelpText("after", "\nAlias: ser\nExamples:\n  $ scai serialization pull -n demo\n  $ scai ser diff -s demo -d prod\n");
+    return command;
+};
+exports.createSerializationCommand = createSerializationCommand;

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

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createPackageCommand: () => Command;
+//# sourceMappingURL=package.d.ts.map

package/dist/commands/serialization/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/commands/serialization/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CpC,eAAO,MAAM,oBAAoB,QAAO,OASvC,CAAC"}

package/dist/commands/serialization/package.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPackageCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("../shared");
+const tasks_1 = require("../../serialization/tasks");
+const createPackageCreateCommand = () => {
+    const command = new commander_1.Command("create").description("Creates a new serialized item package");
+    (0, shared_1.addPackageCreateOptions)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => (0, tasks_1.runPackageCreate)(options));
+    return command;
+};
+const createPackageInstallCommand = () => {
+    const command = new commander_1.Command("install").description("Install an existing item package to Sitecore");
+    (0, shared_1.addPackageInstallOptions)(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addIncludeExcludeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    (0, shared_1.addPublishOptions)(command);
+    command.action(async (options) => (0, tasks_1.runPackageInstall)(options));
+    return command;
+};
+const createPackageCommand = () => {
+    const command = new commander_1.Command("package")
+        .description("Create or install packages of serialized items")
+        .alias("pkg");
+    command.addCommand(createPackageCreateCommand());
+    command.addCommand(createPackageInstallCommand());
+    return command;
+};
+exports.createPackageCommand = createPackageCommand;