@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/commands/agents/sync.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentsSyncCommand = void 0;
+/**
+ * `scai agents sync` — pull, diff, and push Agentic Studio resources as
+ * declarative recipes. `--kind` selects the resource (agent | skill |
+ * widget | custom-mcp); the recipe / sync model is shared with the other
+ * areas — see docs/recipe-sync-architecture.md.
+ *
+ *   pull  capture a live resource into a recipe file
+ *   diff  show the plan to converge a resource onto a recipe
+ *   push  apply that plan (dry-run unless --allow-write)
+ */
+const commander_1 = require("commander");
+const recipe_1 = require("../../agents/recipe");
+const root_config_1 = require("../../config/root-config");
+const cli_tasks_1 = require("../../shared/cli-tasks");
+const sync_1 = require("../../sync");
+const shared_1 = require("../shared");
+const KIND_NAMES = ["agent", "skill", "widget", "custom-mcp", "schema", "html-template"];
+/** Resolve the `--kind` option to a recipe kind, or fail with a hint. */
+const resolveKind = (kindName) => {
+    if (!kindName || !(kindName in recipe_1.agentRecipeKindByName)) {
+        throw (0, cli_tasks_1.inputError)(`--kind must be one of: ${KIND_NAMES.join(", ")}.`, "Pass e.g. `--kind agent`.");
+    }
+    return recipe_1.agentRecipeKindByName[kindName];
+};
+/** Slugify a name for a default recipe filename. */
+const slug = (value) => value
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "") || "recipe";
+const buildContext = (options, logger) => {
+    const configPath = options.config ?? process.cwd();
+    const root = (0, root_config_1.readRootConfiguration)(configPath, options.environmentName);
+    return {
+        environmentName: options.environmentName ?? root.defaultEnvironment,
+        configPath,
+        logger,
+    };
+};
+const PLAN_MARK = { create: "+", update: "~", delete: "-", noop: "=" };
+const printPlan = (logger, plan) => {
+    if (plan.changes.length === 0) {
+        logger.info("Plan: no changes.");
+        return;
+    }
+    for (const change of plan.changes) {
+        logger.info(`  ${PLAN_MARK[change.kind] ?? "?"} ${change.summary}`);
+    }
+    const tally = (0, sync_1.summarizePlan)(plan);
+    logger.info(`Plan: ${tally.create} create, ${tally.update} update, ${tally.delete} delete, ${tally.noop} unchanged.`);
+};
+const recipeName = (recipe) => String(recipe.name ?? "");
+const addKindOption = (command) => {
+    command.addOption(new commander_1.Option("--kind <kind>", `Recipe kind: ${KIND_NAMES.join(" | ")}`));
+};
+const createPullCommand = () => {
+    const command = new commander_1.Command("pull")
+        .description("Capture a live Agentic Studio resource as a recipe file.")
+        .requiredOption("--name <name>", "Resource display name")
+        .addOption(new commander_1.Option("--file <path>", "Output recipe file (default: <name>.<kind>.yaml)"));
+    addKindOption(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        const logger = (0, cli_tasks_1.toLogger)(options);
+        const kind = resolveKind(options.kind);
+        const ctx = buildContext(options, logger);
+        const name = options.name ?? "";
+        const recipe = await (0, sync_1.syncPull)(kind, { kind: kind.name, id: name }, ctx);
+        if (!recipe) {
+            throw (0, cli_tasks_1.inputError)(`No ${kind.name} named "${name}".`, "Check the name with `scai agents list`.");
+        }
+        const file = options.file ?? `${slug(name)}.${kind.name}.yaml`;
+        (0, sync_1.writeRecipe)(file, recipe);
+        logger.info(`Pulled "${name}" -> ${file}`, "green");
+    });
+    return command;
+};
+const createDiffCommand = () => {
+    const command = new commander_1.Command("diff")
+        .description("Show the plan to converge a resource onto a recipe file.")
+        .requiredOption("--file <path>", "Recipe file (.yaml / .json)");
+    addKindOption(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        const logger = (0, cli_tasks_1.toLogger)(options);
+        const kind = resolveKind(options.kind);
+        const ctx = buildContext(options, logger);
+        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", kind.schema);
+        const plan = await (0, sync_1.syncDiff)(kind, recipe, { kind: kind.name, id: recipeName(recipe) }, ctx);
+        printPlan(logger, plan);
+    });
+    return command;
+};
+const createPushCommand = () => {
+    const command = new commander_1.Command("push")
+        .description("Converge a resource onto a recipe file. Dry-run unless --allow-write.")
+        .requiredOption("--file <path>", "Recipe file (.yaml / .json)")
+        .addOption(new commander_1.Option("--allow-write", "Apply the plan (default is a dry-run)"));
+    addKindOption(command);
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.action(async (options) => {
+        const logger = (0, cli_tasks_1.toLogger)(options);
+        const kind = resolveKind(options.kind);
+        const ctx = buildContext(options, logger);
+        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", kind.schema);
+        const mode = options.allowWrite ? "apply" : "what-if";
+        const outcome = await (0, sync_1.syncPush)(kind, recipe, { kind: kind.name, id: recipeName(recipe) }, ctx, {
+            mode,
+        });
+        printPlan(logger, outcome.plan);
+        if (outcome.result) {
+            logger.info(`Applied ${outcome.result.applied.length} change(s); ${outcome.result.skipped.length} skipped.`, "green");
+        }
+        else if ((0, sync_1.planIsNoop)(outcome.plan)) {
+            logger.info("Already converged — nothing to do.", "green");
+        }
+        else {
+            logger.info("Dry-run. Re-run with --allow-write to apply.");
+        }
+    });
+    return command;
+};
+/** `scai agents sync` — recipe pull / diff / push for Agentic Studio resources. */
+const createAgentsSyncCommand = () => {
+    const command = new commander_1.Command("sync").description("Pull, diff, and push Agentic Studio resources as declarative recipes.");
+    command.addCommand(createPullCommand());
+    command.addCommand(createDiffCommand());
+    command.addCommand(createPushCommand());
+    return command;
+};
+exports.createAgentsSyncCommand = createAgentsSyncCommand;

package/dist/commands/audit/all.d.ts

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

package/dist/commands/audit/all.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditAllCommand = void 0;
+const commander_1 = require("commander");
+const all_1 = require("../../hygiene/tasks/audit/all");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditAllCommand = () => {
+    const command = new commander_1.Command("all").description("Run every audit and emit a consolidated report (skip find-replace; it needs --pattern)");
+    (0, shared_2.addAuditBaseOptions)(command);
+    command.option("--include <audits>", "Comma-separated list of audit names to run (default: every audit except find-replace)", shared_1.collectList, []);
+    command.option("--exclude-audit <audits>", "Comma-separated list of audit names to skip", shared_1.collectList, []);
+    command.option("--update-baseline", "After running, write the current findings to the baseline file (use after manual review)");
+    command.option("--root <path>", "Default content root for sub-audits (default: /sitecore/content)");
+    command.addHelpText("after", "\nExamples:\n" +
+        "  $ scai hygiene audit all                              # run everything, print JSON\n" +
+        "  $ scai hygiene audit all --baseline                   # only new findings vs. baseline\n" +
+        "  $ scai hygiene audit all --output report.md           # Markdown report\n" +
+        "  $ scai hygiene audit all --include broken-links,unused-media\n" +
+        "  $ scai hygiene audit all --update-baseline            # accept everything as the new baseline\n");
+    command.action(async (options) => {
+        await (0, all_1.runAuditAll)(options);
+    });
+    return command;
+};
+exports.createAuditAllCommand = createAuditAllCommand;

package/dist/commands/audit/alt-text-missing.d.ts

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

package/dist/commands/audit/alt-text-missing.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditAltTextMissingCommand = void 0;
+const commander_1 = require("commander");
+const alt_text_missing_1 = require("../../hygiene/tasks/audit/alt-text-missing");
+const shared_1 = require("./shared");
+const createAuditAltTextMissingCommand = () => {
+    const command = new commander_1.Command("alt-text-missing").description("Find Image-field values with empty alt text (accessibility audit)");
+    const list = new commander_1.Command("list").description("List items whose Image fields have empty or missing alt attribute");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language");
+    list.action(async (options) => {
+        await (0, alt_text_missing_1.runAuditAltTextMissing)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditAltTextMissingCommand = createAuditAltTextMissingCommand;

package/dist/commands/audit/baseline.d.ts

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

package/dist/commands/audit/baseline.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditBaselineCommand = void 0;
+const commander_1 = require("commander");
+const baseline_1 = require("../../hygiene/tasks/audit/baseline");
+const shared_1 = require("../shared");
+const createAuditBaselineCommand = () => {
+    const command = new commander_1.Command("baseline").description("Manage the per-env audit baseline (ignore-list of accepted findings)");
+    const show = new commander_1.Command("show").description("Print the current baseline contents");
+    (0, shared_1.addEnvironmentOption)(show);
+    (0, shared_1.addConfigOption)(show);
+    (0, shared_1.addVerbosityOptions)(show);
+    show.action(async (options) => {
+        await (0, baseline_1.runBaselineShow)(options);
+    });
+    command.addCommand(show);
+    const create = new commander_1.Command("create").description("Run audits and add every current finding to the baseline (accept-all snapshot)");
+    (0, shared_1.addEnvironmentOption)(create);
+    (0, shared_1.addConfigOption)(create);
+    (0, shared_1.addVerbosityOptions)(create);
+    create.option("--audits <names>", "Comma-separated audit names to snapshot. Default: all audits", shared_1.collectList, []);
+    create.option("--reset", "Reset the baseline for the chosen audits before adding new entries");
+    create.option("--root <path>", "Default content root (default: /sitecore/content)");
+    create.option("--limit <count>", "Cap on items per audit", (v) => parseInt(v, 10));
+    create.option("--include-system", "Include /sitecore/system items");
+    create.action(async (options) => {
+        await (0, baseline_1.runBaselineCreate)(options);
+    });
+    command.addCommand(create);
+    const remove = new commander_1.Command("remove").description("Remove a single entry from the baseline");
+    (0, shared_1.addEnvironmentOption)(remove);
+    (0, shared_1.addConfigOption)(remove);
+    (0, shared_1.addVerbosityOptions)(remove);
+    remove.requiredOption("--audit <name>", "Audit name (e.g. broken-links)");
+    remove.requiredOption("--fingerprint <hex>", "Fingerprint shown by `audit baseline show`");
+    remove.action(async (options) => {
+        await (0, baseline_1.runBaselineRemove)(options);
+    });
+    command.addCommand(remove);
+    const reset = new commander_1.Command("reset").description("Wipe the baseline for one audit (or all audits if --audit is omitted)");
+    (0, shared_1.addEnvironmentOption)(reset);
+    (0, shared_1.addConfigOption)(reset);
+    (0, shared_1.addVerbosityOptions)(reset);
+    reset.option("--audit <name>", "Audit name to reset (default: all)");
+    reset.action(async (options) => {
+        await (0, baseline_1.runBaselineReset)(options);
+    });
+    command.addCommand(reset);
+    const accept = new commander_1.Command("accept").description("Read a `ScaiEnvelope` from stdin (an audit's --json output) and add its findings to the baseline");
+    (0, shared_1.addEnvironmentOption)(accept);
+    (0, shared_1.addConfigOption)(accept);
+    (0, shared_1.addVerbosityOptions)(accept);
+    accept.requiredOption("--audit <name>", "Audit name the findings belong to (e.g. broken-links). Must match the audit that produced the envelope.");
+    accept.option("--note <text>", "Optional note recorded with every accepted entry");
+    accept.option("--from-stdin", "Read the audit envelope from stdin (required; pipe `audit X list --json` in)");
+    accept.addHelpText("after", "\nPipeline form:\n" +
+        "  $ scai hygiene audit broken-links list --json \\\n" +
+        "    | scai hygiene audit baseline accept --audit broken-links --note 'known debt'\n\n" +
+        "Skips fingerprints already in the baseline so the pipeline is idempotent.\n");
+    accept.action(async (options) => {
+        await (0, baseline_1.runBaselineAccept)(options);
+    });
+    command.addCommand(accept);
+    command.addHelpText("after", "\nThe baseline lives at `.scai/audit-baseline-<envName>.json` (per-env).\n" +
+        "Pass --baseline to any audit command to filter out findings that match.\n" +
+        "\nWorkflow:\n" +
+        "  1. scai hygiene audit all                    # see all findings\n" +
+        "  2. scai hygiene audit baseline create        # accept everything as the new baseline\n" +
+        "  3. scai hygiene audit all --baseline         # in CI: only flag NEW findings\n" +
+        "\nIncremental accept:\n" +
+        "  scai hygiene audit broken-links list --json \\\n" +
+        "    | scai hygiene audit baseline accept --audit broken-links\n");
+    return command;
+};
+exports.createAuditBaselineCommand = createAuditBaselineCommand;

package/dist/commands/audit/broken-images.d.ts

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

package/dist/commands/audit/broken-images.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditBrokenImagesCommand = void 0;
+const commander_1 = require("commander");
+const broken_images_1 = require("../../hygiene/tasks/audit/broken-images");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditBrokenImagesCommand = () => {
+    const command = new commander_1.Command("broken-images").description("Find <img src> URLs in RichText fields that fail HTTP HEAD (404, timeout, network)");
+    const list = new commander_1.Command("list").description("Probe each <img> URL with HEAD and report non-2xx / timeouts");
+    (0, shared_2.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language");
+    list.option("--request-timeout-ms <ms>", "Per-URL HEAD timeout in ms (default 5000)", (v) => parseInt(v, 10));
+    list.option("--url-limit <count>", "Max distinct URLs probed in one run (default 500)", (v) => parseInt(v, 10));
+    list.option("--exclude-domains <hosts>", "Comma-separated hostnames to skip (e.g. third-party CDNs you can't reach)", shared_1.collectList, []);
+    list.addHelpText("after", "\nNote: makes external HTTP requests. Excluded from `audit all` by default;\n" +
+        "include with `--include broken-images` when running explicitly.\n");
+    list.action(async (options) => {
+        await (0, broken_images_1.runAuditBrokenImages)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditBrokenImagesCommand = createAuditBrokenImagesCommand;

package/dist/commands/audit/broken-links.d.ts

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

package/dist/commands/audit/broken-links.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditBrokenLinksCommand = void 0;
+const commander_1 = require("commander");
+const broken_links_1 = require("../../hygiene/tasks/audit/broken-links");
+const shared_1 = require("./shared");
+const createAuditBrokenLinksCommand = () => {
+    const command = new commander_1.Command("broken-links").description("Find content items with internal links that point to deleted items");
+    const list = new commander_1.Command("list").description("List items containing broken internal links (RichText, General Link, Multilist)");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.action(async (options) => {
+        await (0, broken_links_1.runAuditBrokenLinks)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditBrokenLinksCommand = createAuditBrokenLinksCommand;

package/dist/commands/audit/datasource-missing.d.ts

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

package/dist/commands/audit/datasource-missing.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditDatasourceMissingCommand = void 0;
+const commander_1 = require("commander");
+const datasource_missing_1 = require("../../hygiene/tasks/audit/datasource-missing");
+const shared_1 = require("./shared");
+const createAuditDatasourceMissingCommand = () => {
+    const command = new commander_1.Command("datasource-missing").description("Find page items with rendering datasources that don't resolve");
+    const list = new commander_1.Command("list").description("List items whose __Renderings / __Final Renderings reference missing datasources");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--report-query-datasources", "Also report Sitecore query: and local: datasources (which can't be resolved statically)");
+    list.action(async (options) => {
+        await (0, datasource_missing_1.runAuditDatasourceMissing)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditDatasourceMissingCommand = createAuditDatasourceMissingCommand;

package/dist/commands/audit/dead-templates.d.ts

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

package/dist/commands/audit/dead-templates.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditDeadTemplatesCommand = void 0;
+const commander_1 = require("commander");
+const dead_templates_1 = require("../../hygiene/tasks/audit/dead-templates");
+const shared_1 = require("./shared");
+const createAuditDeadTemplatesCommand = () => {
+    const command = new commander_1.Command("dead-templates").description("Find item templates with zero items derived from them");
+    const list = new commander_1.Command("list").description("List unused item templates");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Template-tree root to scan (default: /sitecore/templates)");
+    list.action(async (options) => {
+        await (0, dead_templates_1.runAuditDeadTemplates)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditDeadTemplatesCommand = createAuditDeadTemplatesCommand;

package/dist/commands/audit/duplicates.d.ts

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

package/dist/commands/audit/duplicates.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditDuplicatesCommand = void 0;
+const commander_1 = require("commander");
+const duplicates_1 = require("../../hygiene/tasks/audit/duplicates");
+const shared_1 = require("./shared");
+const createAuditDuplicatesCommand = () => {
+    const command = new commander_1.Command("duplicates").description("Find items with byte-identical authored content");
+    const list = new commander_1.Command("list").description("List duplicate-content groups (>= 2 members each, by default)");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language (default: include all)");
+    list.option("--min-group-size <count>", "Only report groups with at least this many duplicates (default: 2)", (v) => parseInt(v, 10));
+    list.option("--include-system-fields", "Include __-prefixed system fields when computing the content hash (off by default to ignore per-item metadata)");
+    list.action(async (options) => {
+        await (0, duplicates_1.runAuditDuplicates)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditDuplicatesCommand = createAuditDuplicatesCommand;

package/dist/commands/audit/empty-items.d.ts

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

package/dist/commands/audit/empty-items.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditEmptyItemsCommand = void 0;
+const commander_1 = require("commander");
+const empty_items_1 = require("../../hygiene/tasks/audit/empty-items");
+const shared_1 = require("./shared");
+const createAuditEmptyItemsCommand = () => {
+    const command = new commander_1.Command("empty-items").description("Find items with no authored field values");
+    const list = new commander_1.Command("list").description("List items where every non-system field is empty or whitespace");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language (default: include all)");
+    list.action(async (options) => {
+        await (0, empty_items_1.runAuditEmptyItems)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditEmptyItemsCommand = createAuditEmptyItemsCommand;

package/dist/commands/audit/empty-links.d.ts

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

package/dist/commands/audit/empty-links.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditEmptyLinksCommand = void 0;
+const commander_1 = require("commander");
+const empty_links_1 = require("../../hygiene/tasks/audit/empty-links");
+const shared_1 = require("./shared");
+const createAuditEmptyLinksCommand = () => {
+    const command = new commander_1.Command("empty-links").description("Find General Link / CTA fields that are structurally empty (link goes nowhere)");
+    const list = new commander_1.Command("list").description("List items whose Link fields have no target (the visible button, the invisible href)");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language");
+    list.option("--template-pattern <regex>", "Restrict to items whose templateName matches this pattern (e.g. CTA|Button|Card)");
+    list.addHelpText("after", "\nWhat this catches (not caught by `audit broken-links`):\n" +
+        "  - Link fields with NO <link> tag at all (truly empty)\n" +
+        "  - <link …/> with all targeting attrs (url/id/anchor/mediaid) empty\n\n" +
+        "Internal-ref-doesn't-resolve is `audit broken-links`. Items where every\n" +
+        "field is empty is `audit empty-items`.\n");
+    list.action(async (options) => {
+        await (0, empty_links_1.runAuditEmptyLinks)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditEmptyLinksCommand = createAuditEmptyLinksCommand;

package/dist/commands/audit/empty-roles.d.ts

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

package/dist/commands/audit/empty-roles.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditEmptyRolesCommand = void 0;
+const commander_1 = require("commander");
+const empty_roles_1 = require("../../hygiene/tasks/audit/empty-roles");
+const shared_1 = require("./shared");
+const createAuditEmptyRolesCommand = () => {
+    const command = new commander_1.Command("empty-roles").description("Find roles with zero direct members");
+    const list = new commander_1.Command("list").description("List roles whose members(first:1) returns an empty connection");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--domain <name>", "Restrict to a specific domain (e.g. sitecore, extranet)");
+    list.action(async (options) => {
+        await (0, empty_roles_1.runAuditEmptyRoles)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditEmptyRolesCommand = createAuditEmptyRolesCommand;

package/dist/commands/audit/fallback-drift.d.ts

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

package/dist/commands/audit/fallback-drift.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditFallbackDriftCommand = void 0;
+const commander_1 = require("commander");
+const fallback_drift_1 = require("../../hygiene/tasks/audit/fallback-drift");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditFallbackDriftCommand = () => {
+    const command = new commander_1.Command("fallback-drift").description("Find items where target-language versions lag the reference language by N days");
+    const list = new commander_1.Command("list").description("Compare updatedDate between --reference-language and --target-language versions");
+    (0, shared_2.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root (default: /sitecore/content)");
+    list.requiredOption("--target-languages <codes>", "Comma-separated target language codes (e.g. fr,de,es)", shared_1.collectList, []);
+    list.option("--reference-language <code>", "Reference (source) language (default: en)");
+    list.option("--drift-days <count>", "Flag items where target lags reference by this many days (default 30)", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, fallback_drift_1.runAuditFallbackDrift)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditFallbackDriftCommand = createAuditFallbackDriftCommand;

package/dist/commands/audit/find-replace.d.ts

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

package/dist/commands/audit/find-replace.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditFindReplaceCommand = void 0;
+const commander_1 = require("commander");
+const find_replace_1 = require("../../hygiene/tasks/audit/find-replace");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditFindReplaceCommand = () => {
+    const command = new commander_1.Command("find-replace").description("Search content field values for a pattern (regex or literal). Read-only counterpart to `cleanup find-replace`.");
+    const list = new commander_1.Command("list").description("List items whose fields contain matches for --pattern");
+    (0, shared_2.addAuditBaseOptions)(list);
+    list.requiredOption("--pattern <regex>", "Regex pattern (or literal string with --literal) to match against field values");
+    list.option("--literal", "Treat --pattern as a literal string (regex special chars escaped)");
+    list.option("--ignore-case", "Case-insensitive match (sets the i regex flag)");
+    list.option("--flags <flags>", "Custom regex flags (g is always added). Default 'g'");
+    list.option("--fields <names>", "Comma-separated field names to search (default: all author-facing fields)", shared_1.collectList, []);
+    list.option("--include-system-fields", "Include __-prefixed system fields in the search (off by default)");
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--language <code>", "Restrict to one language");
+    list.option("--max-matches-per-item <count>", "Maximum number of sample snippets captured per matching item (default 10)", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, find_replace_1.runAuditFindReplace)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditFindReplaceCommand = createAuditFindReplaceCommand;

package/dist/commands/audit/heavy-templates.d.ts

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

package/dist/commands/audit/heavy-templates.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditHeavyTemplatesCommand = void 0;
+const commander_1 = require("commander");
+const heavy_templates_1 = require("../../hygiene/tasks/audit/heavy-templates");
+const shared_1 = require("./shared");
+const createAuditHeavyTemplatesCommand = () => {
+    const command = new commander_1.Command("heavy-templates").description("Find templates with more than N fields (slow editor + brittle fixtures)");
+    const list = new commander_1.Command("list").description("List templates with field count >= --threshold (default 50)");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Template-tree root (default: /sitecore/templates)");
+    list.option("--threshold <count>", "Field-count threshold (default 50)", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, heavy_templates_1.runAuditHeavyTemplates)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditHeavyTemplatesCommand = createAuditHeavyTemplatesCommand;

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

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

package/dist/commands/audit/history.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditHistoryCommand = void 0;
+const commander_1 = require("commander");
+const history_1 = require("../../hygiene/tasks/audit/history");
+const shared_1 = require("../shared");
+const createAuditHistoryCommand = () => {
+    const command = new commander_1.Command("history").description("Snapshot audit-all results over time + diff across snapshots");
+    const capture = new commander_1.Command("capture").description("Run `audit all` and persist the result to .scai/audit-history/<env>/");
+    (0, shared_1.addEnvironmentOption)(capture);
+    (0, shared_1.addConfigOption)(capture);
+    (0, shared_1.addVerbosityOptions)(capture);
+    capture.option("--root <path>", "Default content root for sub-audits");
+    capture.option("--limit <count>", "Cap per audit", (v) => parseInt(v, 10));
+    capture.option("--include-system", "Include /sitecore/system items");
+    capture.option("--include <audits>", "Comma-separated audit names", shared_1.collectList, []);
+    capture.option("--exclude-audit <audits>", "Comma-separated audit names to skip", shared_1.collectList, []);
+    capture.option("--exclude <path>", "Path-prefix exclusions", shared_1.collectList, []);
+    capture.option("--since <date>", "Only items updated on/after this date");
+    capture.action(async (options) => {
+        await (0, history_1.runHistoryCapture)(options);
+    });
+    command.addCommand(capture);
+    const list = new commander_1.Command("list").description("List captured snapshots, newest first");
+    (0, shared_1.addEnvironmentOption)(list);
+    (0, shared_1.addConfigOption)(list);
+    (0, shared_1.addVerbosityOptions)(list);
+    list.action(async (options) => {
+        await (0, history_1.runHistoryList)(options);
+    });
+    command.addCommand(list);
+    const diff = new commander_1.Command("diff").description("Compare two snapshots and show per-audit deltas (defaults to last two)");
+    (0, shared_1.addEnvironmentOption)(diff);
+    (0, shared_1.addConfigOption)(diff);
+    (0, shared_1.addVerbosityOptions)(diff);
+    diff.option("--from <file>", "Snapshot path to compare FROM (default: second-most-recent)");
+    diff.option("--to <file>", "Snapshot path to compare TO (default: most-recent)");
+    diff.action(async (options) => {
+        await (0, history_1.runHistoryDiff)(options);
+    });
+    command.addCommand(diff);
+    return command;
+};
+exports.createAuditHistoryCommand = createAuditHistoryCommand;

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

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