@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/commands/deploy/environments/variables.js

@@ -2,19 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEnvironmentsVariablesCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../../deploy/tasks");
-const shared_1 = require("../shared");
+const environments_1 = require("../../../deploy/tasks/environments");
+const shared_1 = require("../../shared");
+const shared_2 = require("../shared");
 const createEnvironmentsVariablesCommand = () => {
     const environmentsVariables = new commander_1.Command("variables").description("Environment variables");
     const environmentsVariablesList = new commander_1.Command("list").description("List environment variables");
-    (0, shared_1.addDeployBaseOptions)(environmentsVariablesList);
+    (0, shared_2.addDeployBaseOptions)(environmentsVariablesList);
     environmentsVariablesList
         .addOption(new commander_1.Option("--id <id>", "Environment ID"))
         .addOption(new commander_1.Option("--name <name>", "Environment name"))
         .addOption(new commander_1.Option("--project <value>", "Project name or ID"));
-    environmentsVariablesList.action(async (options) => (0, tasks_1.runDeployEnvironmentsVariablesList)(options));
+    environmentsVariablesList.action(async (options) => (0, environments_1.runDeployEnvironmentsVariablesList)(options));
     const environmentsVariablesCreate = new commander_1.Command("create").description("Create or update an environment variable");
-    (0, shared_1.addDeployBaseOptions)(environmentsVariablesCreate);
+    (0, shared_2.addDeployBaseOptions)(environmentsVariablesCreate);
     environmentsVariablesCreate
         .addOption(new commander_1.Option("--id <id>", "Environment ID"))
         .addOption(new commander_1.Option("--name <name>", "Environment name"))
@@ -23,15 +24,15 @@ const createEnvironmentsVariablesCommand = () => {
         .addOption(new commander_1.Option("--value <value>", "Variable value"))
         .addOption(new commander_1.Option("--target <value>", "Variable target"))
         .addOption(new commander_1.Option("--secret", "Store the variable as secret"));
-    environmentsVariablesCreate.action(async (options) => (0, tasks_1.runDeployEnvironmentsVariablesCreate)(options));
+    environmentsVariablesCreate.action(async (options) => (0, environments_1.runDeployEnvironmentsVariablesCreate)(options));
     const environmentsVariablesDelete = new commander_1.Command("delete").description("Delete an environment variable");
-    (0, shared_1.addDeployBaseOptions)(environmentsVariablesDelete);
+    (0, shared_2.addDeployBaseOptions)(environmentsVariablesDelete);
     environmentsVariablesDelete
         .addOption(new commander_1.Option("--id <id>", "Environment ID"))
         .addOption(new commander_1.Option("--name <name>", "Environment name"))
         .addOption(new commander_1.Option("--project <value>", "Project name or ID"))
         .addOption(new commander_1.Option("--variable <name>", "Variable name"));
-    environmentsVariablesDelete.action(async (options) => (0, tasks_1.runDeployEnvironmentsVariablesDelete)(options));
+    environmentsVariablesDelete.action((0, shared_1.withApplyGate)(environments_1.runDeployEnvironmentsVariablesDelete));
     environmentsVariables.addCommand(environmentsVariablesCreate);
     environmentsVariables.addCommand(environmentsVariablesDelete);
     environmentsVariables.addCommand(environmentsVariablesList);

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

@@ -1,2 +1 @@
 export * from "./environments/index";
-//# sourceMappingURL=environments.d.ts.map

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

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

package/dist/commands/deploy/index.js

@@ -20,7 +20,7 @@ const createDeployCommand = () => {
     command.addCommand((0, projects_1.createDeployProjectsCommand)());
     command.addCommand((0, site_1.createDeploySiteCommand)());
     command.addCommand((0, source_control_1.createDeploySourceControlCommand)());
-    command.addHelpText("after", '\nExamples:\n  $ scai deploy projects list\n  $ scai deploy environments list --project "My Project" --type cm\n  $ scai deploy site list --environment-name myenv --hostnames\n');
+    command.addHelpText("after", '\nExamples:\n  $ scai provision deploy projects list\n  $ scai provision deploy environments list --project "My Project" --type cm\n  $ scai provision deploy site list --environment-name myenv --hostnames\n');
     return command;
 };
 exports.createDeployCommand = createDeployCommand;

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

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

package/dist/commands/deploy/logs.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeployLogsCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../deploy/tasks");
+const logs_1 = require("../../deploy/tasks/logs");
 const shared_1 = require("./shared");
 const createDeployLogsCommand = () => {
     const logs = new commander_1.Command("logs").description("Environment log files").alias("log");
@@ -13,7 +13,7 @@ const createDeployLogsCommand = () => {
         .addOption(new commander_1.Option("--name <name>", "Environment name"))
         .addOption(new commander_1.Option("--project <value>", "Project name or ID"))
         .addOption(new commander_1.Option("--latest", "List only the latest logs"));
-    logsList.action(async (options) => (0, tasks_1.runDeployLogsList)(options));
+    logsList.action(async (options) => (0, logs_1.runDeployLogsList)(options));
     const logsView = new commander_1.Command("view").description("View a log file");
     (0, shared_1.addDeployBaseOptions)(logsView);
     logsView
@@ -21,7 +21,7 @@ const createDeployLogsCommand = () => {
         .addOption(new commander_1.Option("--name <name>", "Environment name"))
         .addOption(new commander_1.Option("--project <value>", "Project name or ID"))
         .addOption(new commander_1.Option("--log <filename>", "Log filename"));
-    logsView.action(async (options) => (0, tasks_1.runDeployLogsView)(options));
+    logsView.action(async (options) => (0, logs_1.runDeployLogsView)(options));
     const logsData = new commander_1.Command("data").description("Download a log file");
     (0, shared_1.addDeployBaseOptions)(logsData);
     logsData
@@ -30,7 +30,7 @@ const createDeployLogsCommand = () => {
         .addOption(new commander_1.Option("--project <value>", "Project name or ID"))
         .addOption(new commander_1.Option("--log <filename>", "Log filename"))
         .addOption(new commander_1.Option("--output <path>", "Output file path"));
-    logsData.action(async (options) => (0, tasks_1.runDeployLogsData)(options));
+    logsData.action(async (options) => (0, logs_1.runDeployLogsData)(options));
     logs.addCommand(logsData);
     logs.addCommand(logsList);
     logs.addCommand(logsView);

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

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

package/dist/commands/deploy/organizations.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeployOrganizationsCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../deploy/tasks");
+const organizations_1 = require("../../deploy/tasks/organizations");
 const shared_1 = require("./shared");
 const createDeployOrganizationsCommand = () => {
     const organizations = new commander_1.Command("organizations")
@@ -10,16 +10,16 @@ const createDeployOrganizationsCommand = () => {
         .alias("org");
     const orgGet = new commander_1.Command("get").description("Get the current organization");
     (0, shared_1.addDeployBaseOptions)(orgGet);
-    orgGet.action(async (options) => (0, tasks_1.runDeployOrganizationsGet)(options));
+    orgGet.action(async (options) => (0, organizations_1.runDeployOrganizationsGet)(options));
     const orgHealth = new commander_1.Command("health").description("Get organization health");
     (0, shared_1.addDeployBaseOptions)(orgHealth);
-    orgHealth.action(async (options) => (0, tasks_1.runDeployOrganizationsHealth)(options));
+    orgHealth.action(async (options) => (0, organizations_1.runDeployOrganizationsHealth)(options));
     const orgLicense = new commander_1.Command("license").description("Get organization license");
     (0, shared_1.addDeployBaseOptions)(orgLicense);
-    orgLicense.action(async (options) => (0, tasks_1.runDeployOrganizationsLicense)(options));
+    orgLicense.action(async (options) => (0, organizations_1.runDeployOrganizationsLicense)(options));
     const orgLaunchDemo = new commander_1.Command("launch-demo").description("Launch demo solution");
     (0, shared_1.addDeployBaseOptions)(orgLaunchDemo);
-    orgLaunchDemo.action(async (options) => (0, tasks_1.runDeployOrganizationsLaunchDemo)(options));
+    orgLaunchDemo.action(async (options) => (0, organizations_1.runDeployOrganizationsLaunchDemo)(options));
     organizations.addCommand(orgGet);
     organizations.addCommand(orgHealth);
     organizations.addCommand(orgLaunchDemo);

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

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

package/dist/commands/deploy/projects.js

@@ -2,36 +2,48 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeployProjectsCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../deploy/tasks");
-const shared_1 = require("./shared");
+const projects_1 = require("../../deploy/tasks/projects");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const parsePositiveInt = (label) => (value) => {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer.`);
+    }
+    return parsed;
+};
 const createDeployProjectsCommand = () => {
     const projects = new commander_1.Command("projects").description("Project operations").alias("proj");
     const projectsList = new commander_1.Command("list").description("List projects");
-    (0, shared_1.addDeployBaseOptions)(projectsList);
-    projectsList.action(async (options) => (0, tasks_1.runDeployProjectsList)(options));
+    (0, shared_2.addDeployBaseOptions)(projectsList);
+    projectsList
+        .addOption(new commander_1.Option("--all", "Fetch every page and return the consolidated result set (default: one page)"))
+        .addOption(new commander_1.Option("--page <n>", "1-based page number (ignored with --all)").argParser(parsePositiveInt("--page")))
+        .addOption(new commander_1.Option("--page-size <n>", "Page size. Defaults to 50 with --all, otherwise the API default (10).").argParser(parsePositiveInt("--page-size")));
+    projectsList.action(async (options) => (0, projects_1.runDeployProjectsList)(options));
     const projectsLimitation = new commander_1.Command("limitation").description("Get project limitations");
-    (0, shared_1.addDeployBaseOptions)(projectsLimitation);
-    projectsLimitation.action(async (options) => (0, tasks_1.runDeployProjectsLimitation)(options));
+    (0, shared_2.addDeployBaseOptions)(projectsLimitation);
+    projectsLimitation.action(async (options) => (0, projects_1.runDeployProjectsLimitation)(options));
     const projectsValidateName = new commander_1.Command("validate-name").description("Validate that a project name is unique");
-    (0, shared_1.addDeployBaseOptions)(projectsValidateName);
+    (0, shared_2.addDeployBaseOptions)(projectsValidateName);
     projectsValidateName.addOption(new commander_1.Option("--name <name>", "Project name"));
-    projectsValidateName.action(async (options) => (0, tasks_1.runDeployProjectsValidateName)(options));
+    projectsValidateName.action(async (options) => (0, projects_1.runDeployProjectsValidateName)(options));
     const projectsGet = new commander_1.Command("get").description("Get a project by name or ID");
-    (0, shared_1.addDeployBaseOptions)(projectsGet);
+    (0, shared_2.addDeployBaseOptions)(projectsGet);
     projectsGet
         .addOption(new commander_1.Option("--id <id>", "Project ID"))
         .addOption(new commander_1.Option("--name <name>", "Project name"));
-    projectsGet.action(async (options) => (0, tasks_1.runDeployProjectsGet)(options));
+    projectsGet.action(async (options) => (0, projects_1.runDeployProjectsGet)(options));
     const projectsCreate = new commander_1.Command("create").description("Create a project");
-    (0, shared_1.addDeployBaseOptions)(projectsCreate);
+    (0, shared_2.addDeployBaseOptions)(projectsCreate);
     projectsCreate
         .addOption(new commander_1.Option("--name <name>", "Project name"))
         .addOption(new commander_1.Option("--repository-name <name>", "Repository name"))
         .addOption(new commander_1.Option("--repository-id <id>", "Repository ID"))
         .addOption(new commander_1.Option("--source-control-integration-id <id>", "Source control integration ID (maps to integrationId)"));
-    projectsCreate.action(async (options) => (0, tasks_1.runDeployProjectsCreate)(options));
+    projectsCreate.action(async (options) => (0, projects_1.runDeployProjectsCreate)(options));
     const projectsUpdate = new commander_1.Command("update").description("Update a project by name or ID");
-    (0, shared_1.addDeployBaseOptions)(projectsUpdate);
+    (0, shared_2.addDeployBaseOptions)(projectsUpdate);
     projectsUpdate
         .addOption(new commander_1.Option("--id <id>", "Project ID"))
         .addOption(new commander_1.Option("--name <name>", "Project name"))
@@ -39,27 +51,27 @@ const createDeployProjectsCommand = () => {
         .addOption(new commander_1.Option("--repository-name <name>", "Repository name"))
         .addOption(new commander_1.Option("--repository-id <id>", "Repository ID"))
         .addOption(new commander_1.Option("--source-control-integration-id <id>", "Source control integration ID (maps to sourceControlIntegrationId)"));
-    projectsUpdate.action(async (options) => (0, tasks_1.runDeployProjectsUpdate)(options));
+    projectsUpdate.action(async (options) => (0, projects_1.runDeployProjectsUpdate)(options));
     const projectsLinkRepository = new commander_1.Command("link-repository").description("Link a repository to a project");
-    (0, shared_1.addDeployBaseOptions)(projectsLinkRepository);
+    (0, shared_2.addDeployBaseOptions)(projectsLinkRepository);
     projectsLinkRepository
         .addOption(new commander_1.Option("--id <id>", "Project ID"))
         .addOption(new commander_1.Option("--repository-name <name>", "Repository name"))
         .addOption(new commander_1.Option("--repository-id <id>", "Repository ID"))
         .addOption(new commander_1.Option("--integration-id <id>", "Integration ID"))
         .addOption(new commander_1.Option("--repository-relative-path <path>", "Repository relative path"));
-    projectsLinkRepository.action(async (options) => (0, tasks_1.runDeployProjectsLinkRepository)(options));
+    projectsLinkRepository.action(async (options) => (0, projects_1.runDeployProjectsLinkRepository)(options));
     const projectsUnlinkRepository = new commander_1.Command("unlink-repository").description("Unlink a repository from a project");
-    (0, shared_1.addDeployBaseOptions)(projectsUnlinkRepository);
+    (0, shared_2.addDeployBaseOptions)(projectsUnlinkRepository);
     projectsUnlinkRepository.addOption(new commander_1.Option("--id <id>", "Project ID"));
-    projectsUnlinkRepository.action(async (options) => (0, tasks_1.runDeployProjectsUnlinkRepository)(options));
+    projectsUnlinkRepository.action((0, shared_1.withApplyGate)(projects_1.runDeployProjectsUnlinkRepository));
     const projectsDelete = new commander_1.Command("delete").description("Delete a project by name or ID");
-    (0, shared_1.addDeployBaseOptions)(projectsDelete);
+    (0, shared_2.addDeployBaseOptions)(projectsDelete);
     projectsDelete
         .addOption(new commander_1.Option("--id <id>", "Project ID"))
         .addOption(new commander_1.Option("--name <name>", "Project name"))
         .addOption(new commander_1.Option("--force", "Skip confirmation prompt"));
-    projectsDelete.action(async (options) => (0, tasks_1.runDeployProjectsDelete)(options));
+    projectsDelete.action((0, shared_1.withApplyGate)(projects_1.runDeployProjectsDelete));
     projects.addCommand(projectsCreate);
     projects.addCommand(projectsDelete);
     projects.addCommand(projectsGet);

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

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

package/dist/commands/deploy/shared.js

@@ -6,6 +6,7 @@ const addDeployBaseOptions = (command) => {
     (0, shared_1.addEnvironmentOption)(command);
     (0, shared_1.addConfigOption)(command);
     (0, shared_1.addWhatIfOption)(command);
+    (0, shared_1.addApplyOption)(command);
     (0, shared_1.addVerbosityOptions)(command);
     return command;
 };

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

@@ -1,10 +1,9 @@
 /**
- * `scai deploy site` — read-only discovery of SXA sites in a CM
+ * `scai provision deploy site` — read-only discovery of SXA sites in a CM
  * environment via the Authoring GraphQL API.
  *
  * Sibling of `deploy editing-host` (which talks to the Deploy API).
- * Uses the same env profile + auth as `scai recipe push`.
+ * Uses the same env profile + auth as `scai provision recipe push`.
  */
 import { Command } from "commander";
 export declare const createDeploySiteCommand: () => Command;
-//# sourceMappingURL=site.d.ts.map

package/dist/commands/deploy/site.js

@@ -1,15 +1,16 @@
 "use strict";
 /**
- * `scai deploy site` — read-only discovery of SXA sites in a CM
+ * `scai provision deploy site` — read-only discovery of SXA sites in a CM
  * environment via the Authoring GraphQL API.
  *
  * Sibling of `deploy editing-host` (which talks to the Deploy API).
- * Uses the same env profile + auth as `scai recipe push`.
+ * Uses the same env profile + auth as `scai provision recipe push`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeploySiteCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../deploy/tasks");
+const site_bind_1 = require("../../deploy/tasks/site-bind");
+const site_1 = require("../../deploy/tasks/site");
 const shared_1 = require("./shared");
 const createDeploySiteCommand = () => {
     const site = new commander_1.Command("site").description("SXA site operations").alias("sites");
@@ -18,7 +19,7 @@ const createDeploySiteCommand = () => {
     list
         .addOption(new commander_1.Option("--hostnames", "Resolve declared hostnames per site (adds an N+1 round trip per site)"))
         .addOption(new commander_1.Option("--content-root <path>", "Override the content root walked. Default `/sitecore/content`."));
-    list.action(async (options) => (0, tasks_1.runDeploySiteList)(options));
+    list.action(async (options) => (0, site_1.runDeploySiteList)(options));
     const bind = new commander_1.Command("bind").description("Populate Site Grouping fields (HostName / StartItem / RenderingHost) so the site appears in Pages / Channels");
     (0, shared_1.addDeployBaseOptions)(bind);
     bind
@@ -28,7 +29,7 @@ const createDeploySiteCommand = () => {
         .addOption(new commander_1.Option("--start-item-name <name>", "Start item name (relative to the site root). Default `Home`."))
         .addOption(new commander_1.Option("--host-name-pattern <value>", "HostName field value. Default `*` (wildcard)."))
         .addOption(new commander_1.Option("--allow-write", "Apply changes (without it, the command runs in plan-only mode)"));
-    bind.action(async (options) => (0, tasks_1.runDeploySiteBind)(options));
+    bind.action(async (options) => (0, site_bind_1.runDeploySiteBind)(options));
     site.addCommand(bind);
     site.addCommand(list);
     return site;

package/dist/commands/deploy/source-control.d.ts

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

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeploySourceControlCommand = void 0;
 const commander_1 = require("commander");
-const tasks_1 = require("../../deploy/tasks");
+const source_control_1 = require("../../deploy/tasks/source-control");
 const shared_1 = require("./shared");
 const createDeploySourceControlCommand = () => {
     const sourceControl = new commander_1.Command("source-control")
@@ -10,37 +10,37 @@ const createDeploySourceControlCommand = () => {
         .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));
+    sourceControlList.action(async (options) => (0, source_control_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));
+    sourceControlState.action(async (options) => (0, source_control_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));
+    sourceControlAccessToken.action(async (options) => (0, source_control_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));
+    sourceControlValidate.action(async (options) => (0, source_control_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));
+    sourceControlRepositoryGet.action(async (options) => (0, source_control_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));
+    sourceControlRepositoryBranches.action(async (options) => (0, source_control_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));
+    sourceControlRepositoryValidate.action(async (options) => (0, source_control_1.runDeploySourceControlRepositoryValidate)(options));
     const sourceControlRepositoryCreateFromTemplate = new commander_1.Command("create-from-template").description("Create repository from template");
     (0, shared_1.addDeployBaseOptions)(sourceControlRepositoryCreateFromTemplate);
     sourceControlRepositoryCreateFromTemplate
@@ -55,26 +55,26 @@ const createDeploySourceControlCommand = () => {
         .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));
+    sourceControlRepositoryCreateFromTemplate.action(async (options) => (0, source_control_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));
+    sourceControlProviders.action(async (options) => (0, source_control_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));
+    sourceControlTemplates.action(async (options) => (0, source_control_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));
+    sourceControlGet.action(async (options) => (0, source_control_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));
+    sourceControlDelete.action(async (options) => (0, source_control_1.runDeploySourceControlDelete)(options));
     sourceControl.addCommand(sourceControlAccessToken);
     sourceControl.addCommand(sourceControlDelete);
     sourceControl.addCommand(sourceControlGet);

package/dist/commands/deploy.d.ts

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

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

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+/**
+ * `scai hygiene explain` — read-only verbs that compose existing
+ * primitives into focused answers to specific operator questions:
+ *
+ *   - `why-blocked <itemId>` — what blocks deleting this item
+ *     (`audit references` + `audit template-dependencies`).
+ *   - `orphan-site <site>`   — what is left behind for a deleted site,
+ *     and what still references it (`audit site-residue` +
+ *     `audit references`).
+ *
+ * Each verb owns its printed report; the audits it composes run silent.
+ */
+export declare const createExplainCommand: () => Command;

package/dist/commands/explain/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExplainCommand = void 0;
+const commander_1 = require("commander");
+const why_blocked_1 = require("./why-blocked");
+const orphan_site_1 = require("./orphan-site");
+/**
+ * `scai hygiene explain` — read-only verbs that compose existing
+ * primitives into focused answers to specific operator questions:
+ *
+ *   - `why-blocked <itemId>` — what blocks deleting this item
+ *     (`audit references` + `audit template-dependencies`).
+ *   - `orphan-site <site>`   — what is left behind for a deleted site,
+ *     and what still references it (`audit site-residue` +
+ *     `audit references`).
+ *
+ * Each verb owns its printed report; the audits it composes run silent.
+ */
+const createExplainCommand = () => {
+    const command = new commander_1.Command("explain").description("Compose multiple audits to answer specific operator questions");
+    command.addCommand((0, why_blocked_1.createExplainWhyBlockedCommand)());
+    command.addCommand((0, orphan_site_1.createExplainOrphanSiteCommand)());
+    return command;
+};
+exports.createExplainCommand = createExplainCommand;

package/dist/commands/explain/orphan-site.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+/**
+ * `scai hygiene explain orphan-site <site>` — read-only verb that
+ * composes `audit site-residue` and `audit references` into one
+ * answer: "here is every orphan tree left behind for this site, and
+ * which of them is still referenced by live content."
+ *
+ * Pair with `cleanup site-residue purge`: this tells you which orphans
+ * are safe to purge now and which need their referrers resolved first.
+ */
+export declare const createExplainOrphanSiteCommand: () => Command;

package/dist/commands/explain/orphan-site.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExplainOrphanSiteCommand = void 0;
+const commander_1 = require("commander");
+const orphan_site_1 = require("../../hygiene/tasks/explain/orphan-site");
+const shared_1 = require("../shared");
+/**
+ * `scai hygiene explain orphan-site <site>` — read-only verb that
+ * composes `audit site-residue` and `audit references` into one
+ * answer: "here is every orphan tree left behind for this site, and
+ * which of them is still referenced by live content."
+ *
+ * Pair with `cleanup site-residue purge`: this tells you which orphans
+ * are safe to purge now and which need their referrers resolved first.
+ */
+const createExplainOrphanSiteCommand = () => {
+    const command = new commander_1.Command("orphan-site")
+        .description("Show the orphan trees left behind for <site>, flagging any still referenced by live content")
+        .argument("<site>", "Site (or tenant) folder name to inspect");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--index <name>", "Override the search index name"))
+        .addOption(new commander_1.Option("--limit <count>", "Cap on inbound refs counted per orphan tree").argParser((v) => parseInt(v, 10)));
+    command.addHelpText("after", "\nAfter a Sites-API site delete, folders survive under\n" +
+        "/sitecore/templates/Project, /layout, and the media library. This\n" +
+        "verb finds them and checks each for inbound references — so you\n" +
+        "know which are safe to `cleanup site-residue purge` and which need\n" +
+        "their referrers resolved first.\n");
+    command.action(async (site, options) => {
+        await (0, orphan_site_1.runExplainOrphanSite)({ ...options, site });
+    });
+    return command;
+};
+exports.createExplainOrphanSiteCommand = createExplainOrphanSiteCommand;

package/dist/commands/explain/why-blocked.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "commander";
+/**
+ * `scai hygiene explain why-blocked <itemId>` — read-only verb that combines
+ * `audit references` and `audit template-dependencies` into one
+ * report: "here is every inbound reference that would block (or
+ * potentially block) a delete of this item, grouped by reference kind."
+ *
+ * Lives in its own command group (`explain/`) rather than under
+ * `audit/` because the verb composes two audits — placing it under
+ * either would imply a hierarchy that doesn't match how operators
+ * reach for it.
+ */
+export declare const createExplainWhyBlockedCommand: () => Command;

package/dist/commands/explain/why-blocked.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExplainWhyBlockedCommand = void 0;
+const commander_1 = require("commander");
+const why_blocked_1 = require("../../hygiene/tasks/explain/why-blocked");
+const shared_1 = require("../shared");
+/**
+ * `scai hygiene explain why-blocked <itemId>` — read-only verb that combines
+ * `audit references` and `audit template-dependencies` into one
+ * report: "here is every inbound reference that would block (or
+ * potentially block) a delete of this item, grouped by reference kind."
+ *
+ * Lives in its own command group (`explain/`) rather than under
+ * `audit/` because the verb composes two audits — placing it under
+ * either would imply a hierarchy that doesn't match how operators
+ * reach for it.
+ */
+const createExplainWhyBlockedCommand = () => {
+    const command = new commander_1.Command("why-blocked")
+        .description("Show every inbound reference that would block a delete of <itemId>, grouped by reference kind")
+        .argument("<itemId>", "Item ID (any GUID form) to inspect");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--root <path>", "Content root for the field-value scan (default: /sitecore/content)"))
+        .addOption(new commander_1.Option("--index <name>", "Override the search index name"))
+        .addOption(new commander_1.Option("--limit <count>", "Cap on results per scan kind (default: 5000)").argParser((v) => parseInt(v, 10)))
+        .addOption(new commander_1.Option("--skip-content-scan", "Skip the field-value content scan. Use when only structural template refs matter (faster)."))
+        .addOption(new commander_1.Option("--skip-template-deps", "Skip the search-index template-dependency check. Use for leaf content items that aren't referenced as templates."))
+        .addOption(new commander_1.Option("--cache", "Reuse the on-disk field cache for the content scan (faster when running back-to-back checks against the same --root)."));
+    command.addHelpText("after", "\nThe Authoring API rejects deletes with terse messages like\n" +
+        '"Template is used by at least one item." This verb tells you which\n' +
+        "items, and by what reference kind. Use before a cleanup or delete\n" +
+        "fails so you can resolve blockers up front instead of decoding the\n" +
+        "API error after the fact.\n");
+    command.action(async (itemId, options) => {
+        await (0, why_blocked_1.runExplainWhyBlocked)({ ...options, itemId });
+    });
+    return command;
+};
+exports.createExplainWhyBlockedCommand = createExplainWhyBlockedCommand;

package/dist/commands/health.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const createHealthCommand: () => Command;

package/dist/commands/health.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHealthCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const health_1 = require("../deploy/tasks/health");
+const parsePositiveInt = (label) => (value) => {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer.`);
+    }
+    return parsed;
+};
+const createHealthCommand = () => {
+    const command = new commander_1.Command("health").description("Show health of every environment in the active tenant");
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command
+        .addOption(new commander_1.Option("--project <value>", "Filter to environments in this project"))
+        .addOption(new commander_1.Option("--type <cm|eh>", "Filter by environment type"))
+        .addOption(new commander_1.Option("--no-probe", "List status only — skip per-env probes"))
+        .addOption(new commander_1.Option("--concurrency <n>", "Probe concurrency (default 8)").argParser(parsePositiveInt("--concurrency")));
+    command.addHelpText("after", `\nExamples:\n  $ scai cli health\n  $ scai cli health --json\n  $ scai cli health --type cm\n  $ scai cli health --no-probe\n`);
+    command.action(async (options) => (0, health_1.runDeployHealth)(options));
+    return command;
+};
+exports.createHealthCommand = createHealthCommand;

package/dist/commands/history.d.ts

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