@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/commands/audit/index.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditCommand = void 0;
+const commander_1 = require("commander");
+const all_1 = require("./all");
+const alt_text_missing_1 = require("./alt-text-missing");
+const baseline_1 = require("./baseline");
+const broken_links_1 = require("./broken-links");
+const heavy_templates_1 = require("./heavy-templates");
+const large_fields_1 = require("./large-fields");
+const broken_images_1 = require("./broken-images");
+const empty_roles_1 = require("./empty-roles");
+const history_1 = require("./history");
+const suite_1 = require("./suite");
+const fallback_drift_1 = require("./fallback-drift");
+const missing_meta_1 = require("./missing-meta");
+const role_bloat_1 = require("./role-bloat");
+const slug_conflicts_1 = require("./slug-conflicts");
+const stale_users_1 = require("./stale-users");
+const translation_coverage_1 = require("./translation-coverage");
+const datasource_missing_1 = require("./datasource-missing");
+const dead_templates_1 = require("./dead-templates");
+const duplicates_1 = require("./duplicates");
+const empty_items_1 = require("./empty-items");
+const empty_links_1 = require("./empty-links");
+const find_replace_1 = require("./find-replace");
+const language_data_1 = require("./language-data");
+const orphans_1 = require("./orphans");
+const page_design_orphans_1 = require("./page-design-orphans");
+const personalization_broken_1 = require("./personalization-broken");
+const references_1 = require("./references");
+const site_residue_1 = require("./site-residue");
+const stale_content_1 = require("./stale-content");
+const stale_workflow_1 = require("./stale-workflow");
+const template_dependencies_1 = require("./template-dependencies");
+const unused_media_1 = require("./unused-media");
+const createAuditCommand = () => {
+    const command = new commander_1.Command("audit").description("Read-only diagnostics over Sitecore content — links, media, archive, workflow, languages, templates, datasources, duplicates, empty items, page designs, personalization");
+    command.addCommand((0, all_1.createAuditAllCommand)());
+    command.addCommand((0, alt_text_missing_1.createAuditAltTextMissingCommand)());
+    command.addCommand((0, baseline_1.createAuditBaselineCommand)());
+    command.addCommand((0, broken_images_1.createAuditBrokenImagesCommand)());
+    command.addCommand((0, broken_links_1.createAuditBrokenLinksCommand)());
+    command.addCommand((0, heavy_templates_1.createAuditHeavyTemplatesCommand)());
+    command.addCommand((0, large_fields_1.createAuditLargeFieldsCommand)());
+    command.addCommand((0, missing_meta_1.createAuditMissingMetaCommand)());
+    command.addCommand((0, datasource_missing_1.createAuditDatasourceMissingCommand)());
+    command.addCommand((0, dead_templates_1.createAuditDeadTemplatesCommand)());
+    command.addCommand((0, duplicates_1.createAuditDuplicatesCommand)());
+    command.addCommand((0, empty_items_1.createAuditEmptyItemsCommand)());
+    command.addCommand((0, empty_links_1.createAuditEmptyLinksCommand)());
+    command.addCommand((0, empty_roles_1.createAuditEmptyRolesCommand)());
+    command.addCommand((0, fallback_drift_1.createAuditFallbackDriftCommand)());
+    command.addCommand((0, find_replace_1.createAuditFindReplaceCommand)());
+    command.addCommand((0, language_data_1.createAuditLanguageDataCommand)());
+    command.addCommand((0, orphans_1.createAuditOrphansCommand)());
+    command.addCommand((0, page_design_orphans_1.createAuditPageDesignOrphansCommand)());
+    command.addCommand((0, personalization_broken_1.createAuditPersonalizationBrokenCommand)());
+    command.addCommand((0, references_1.createAuditReferencesCommand)());
+    command.addCommand((0, role_bloat_1.createAuditRoleBloatCommand)());
+    command.addCommand((0, site_residue_1.createAuditSiteResidueCommand)());
+    command.addCommand((0, slug_conflicts_1.createAuditSlugConflictsCommand)());
+    command.addCommand((0, stale_content_1.createAuditStaleContentCommand)());
+    command.addCommand((0, stale_users_1.createAuditStaleUsersCommand)());
+    command.addCommand((0, stale_workflow_1.createAuditStaleWorkflowCommand)());
+    command.addCommand((0, template_dependencies_1.createAuditTemplateDependenciesCommand)());
+    command.addCommand((0, history_1.createAuditHistoryCommand)());
+    command.addCommand((0, suite_1.createAuditSuiteCommand)());
+    command.addCommand((0, translation_coverage_1.createAuditTranslationCoverageCommand)());
+    command.addCommand((0, unused_media_1.createAuditUnusedMediaCommand)());
+    command.addHelpText("after", [
+        "",
+        "Audits read master-database state via the Authoring API — findings",
+        "reflect master, not what Experience Edge currently serves.",
+        "",
+        "Audits by theme:",
+        "  Links & references   broken-links, empty-links, references,",
+        "                       datasource-missing, personalization-broken",
+        "  Media & assets       broken-images, alt-text-missing, unused-media,",
+        "                       large-fields",
+        "  Templates & layout   dead-templates, heavy-templates,",
+        "                       template-dependencies, page-design-orphans",
+        "  Content health       duplicates, empty-items, orphans, slug-conflicts,",
+        "                       stale-content, missing-meta",
+        "  Languages            fallback-drift, language-data, translation-coverage",
+        "  Workflow & access    stale-workflow, stale-users, role-bloat, empty-roles",
+        "  Site residue         site-residue",
+        "  Search               find-replace",
+        "  Run & manage         all, suite, baseline, history",
+        "",
+        "Examples (each audit's --help has its full option set):",
+        "  $ scai hygiene audit broken-links list --root /sitecore/content/MySite",
+        "  $ scai hygiene audit dead-templates list --root /sitecore/templates/Project",
+        "  $ scai hygiene audit duplicates list --min-group-size 3 --json",
+        "  $ scai hygiene audit all                       # run every audit",
+        "",
+    ].join("\n"));
+    return command;
+};
+exports.createAuditCommand = createAuditCommand;

package/dist/commands/audit/language-data.d.ts

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

package/dist/commands/audit/language-data.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditLanguageDataCommand = void 0;
+const commander_1 = require("commander");
+const language_data_1 = require("../../hygiene/tasks/audit/language-data");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditLanguageDataCommand = () => {
+    const command = new commander_1.Command("language-data").description("Find items with empty per-language entries (no versions) — read-only diagnostic");
+    const list = new commander_1.Command("list").description("List (item, language) pairs where the language entry exists but has zero versions");
+    (0, shared_2.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--languages <value>", "Comma-separated language codes to inspect (default: all languages found under --root)", shared_1.collectList, []);
+    list.addHelpText("after", "\nNote: XM Cloud Authoring API does not expose per-item language-entry removal,\n" +
+        "so this command is read-only. Operators clean up empty entries by either\n" +
+        "authoring at least one version in the affected language, or removing the\n" +
+        "language tenant-wide via the Sitecore admin tools.\n");
+    list.action(async (options) => {
+        await (0, language_data_1.runAuditLanguageData)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditLanguageDataCommand = createAuditLanguageDataCommand;

package/dist/commands/audit/large-fields.d.ts

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

package/dist/commands/audit/large-fields.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditLargeFieldsCommand = void 0;
+const commander_1 = require("commander");
+const large_fields_1 = require("../../hygiene/tasks/audit/large-fields");
+const shared_1 = require("./shared");
+const createAuditLargeFieldsCommand = () => {
+    const command = new commander_1.Command("large-fields").description("Find content items with field values exceeding a byte-size threshold");
+    const list = new commander_1.Command("list").description("List items whose individual field values are >= --threshold bytes (default 100KB)");
+    (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("--threshold <bytes>", "Field-size threshold in bytes (default 100000 = 100KB)", (v) => parseInt(v, 10));
+    list.option("--include-system-fields", "Include __-prefixed system fields in the size check");
+    list.action(async (options) => {
+        await (0, large_fields_1.runAuditLargeFields)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditLargeFieldsCommand = createAuditLargeFieldsCommand;

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

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

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditMissingMetaCommand = void 0;
+const commander_1 = require("commander");
+const missing_meta_1 = require("../../hygiene/tasks/audit/missing-meta");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditMissingMetaCommand = () => {
+    const command = new commander_1.Command("missing-meta").description("Find items missing required (SEO) field values");
+    const list = new commander_1.Command("list").description("List items lacking any of the required fields (default SEO set)");
+    (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("--required-fields <names>", "Comma-separated required field names (default: meta-title,meta-description,og-image,og-title)", shared_1.collectList, []);
+    list.option("--template-pattern <regex>", "Only check items whose templateName matches (e.g. 'Page' for SXA pages)");
+    list.action(async (options) => {
+        await (0, missing_meta_1.runAuditMissingMeta)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditMissingMetaCommand = createAuditMissingMetaCommand;

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

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

package/dist/commands/audit/orphans.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditOrphansCommand = void 0;
+const commander_1 = require("commander");
+const orphans_1 = require("../../hygiene/tasks/audit/orphans");
+const shared_1 = require("../shared");
+const createAuditOrphansCommand = () => {
+    const command = new commander_1.Command("orphans").description("Find items in the Sitecore archive (recycle bin) — the XM Cloud analogue of orphan items");
+    const list = new commander_1.Command("list").description("List archived (orphan) items");
+    (0, shared_1.addEnvironmentOption)(list);
+    (0, shared_1.addConfigOption)(list);
+    (0, shared_1.addVerbosityOptions)(list);
+    list.option("--archive-name <name>", "Limit to a specific archive (default: all archives)");
+    list.option("--page-size <count>", "Page size for the archive listing", (v) => parseInt(v, 10));
+    list.option("--limit <count>", "Maximum number of archived items to return", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, orphans_1.runAuditOrphans)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditOrphansCommand = createAuditOrphansCommand;

package/dist/commands/audit/page-design-orphans.d.ts

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

package/dist/commands/audit/page-design-orphans.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditPageDesignOrphansCommand = void 0;
+const commander_1 = require("commander");
+const page_design_orphans_1 = require("../../hygiene/tasks/audit/page-design-orphans");
+const shared_1 = require("./shared");
+const createAuditPageDesignOrphansCommand = () => {
+    const command = new commander_1.Command("page-design-orphans").description("Find pages referencing missing page designs (XM Cloud SXA)");
+    const list = new commander_1.Command("list").description("List pages whose __Final Page Design / __Page Design field points to a missing item");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.action(async (options) => {
+        await (0, page_design_orphans_1.runAuditPageDesignOrphans)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditPageDesignOrphansCommand = createAuditPageDesignOrphansCommand;

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

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

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditPersonalizationBrokenCommand = void 0;
+const commander_1 = require("commander");
+const personalization_broken_1 = require("../../hygiene/tasks/audit/personalization-broken");
+const shared_1 = require("./shared");
+const createAuditPersonalizationBrokenCommand = () => {
+    const command = new commander_1.Command("personalization-broken").description("Find pages with personalization rules referencing missing items");
+    const list = new commander_1.Command("list").description("List items with broken personalization variant or rule-set references");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.action(async (options) => {
+        await (0, personalization_broken_1.runAuditPersonalizationBroken)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditPersonalizationBrokenCommand = createAuditPersonalizationBrokenCommand;

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

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

package/dist/commands/audit/references.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditReferencesCommand = void 0;
+const commander_1 = require("commander");
+const references_1 = require("../../hygiene/tasks/audit/references");
+const shared_1 = require("./shared");
+const createAuditReferencesCommand = () => {
+    const command = new commander_1.Command("references").description("Find every item with a field that references a target item — generic inbound-reference scan");
+    const list = new commander_1.Command("list").description("List inbound references to an item");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.requiredOption("--to <guid>", "Item ID to find references for (any GUID form)");
+    list.option("--root <path>", "Content root to scan (default: /sitecore/content)");
+    list.option("--fields <name>", "Restrict scan to these field names. Repeat or comma-separate.", (v, prev = []) => prev.concat(v
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)), []);
+    list.option("--exclude-system-fields", "Skip `__`-prefixed system fields. Off by default — system fields (Renderings, Layout, etc.) carry most cross-item references.");
+    list.action(async (options) => {
+        await (0, references_1.runAuditReferences)({
+            ...options,
+            includeSystemFields: !options.excludeSystemFields,
+        });
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditReferencesCommand = createAuditReferencesCommand;

package/dist/commands/audit/role-bloat.d.ts

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

package/dist/commands/audit/role-bloat.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditRoleBloatCommand = void 0;
+const commander_1 = require("commander");
+const role_bloat_1 = require("../../hygiene/tasks/audit/role-bloat");
+const shared_1 = require("./shared");
+const createAuditRoleBloatCommand = () => {
+    const command = new commander_1.Command("role-bloat").description("Find users with more than N role memberships (default 10)");
+    const list = new commander_1.Command("list").description("List users whose direct role count exceeds --threshold");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--threshold <count>", "Role-count threshold (default 10)", (v) => parseInt(v, 10));
+    list.option("--include-admins", "Include administrators (off by default)");
+    list.action(async (options) => {
+        await (0, role_bloat_1.runAuditRoleBloat)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditRoleBloatCommand = createAuditRoleBloatCommand;

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

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+/**
+ * Standard option set for `scai hygiene audit *` commands. Includes the perf
+ * knobs — `--concurrency`, `--batch-size`, `--page-parallel`, `--cache`
+ * — that override env-default values resolved by `resolveHygieneKnobs`.
+ */
+export declare const addAuditBaseOptions: (command: Command) => Command;

package/dist/commands/audit/shared.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addAuditBaseOptions = void 0;
+const shared_1 = require("../shared");
+/**
+ * Standard option set for `scai hygiene audit *` commands. Includes the perf
+ * knobs — `--concurrency`, `--batch-size`, `--page-parallel`, `--cache`
+ * — that override env-default values resolved by `resolveHygieneKnobs`.
+ */
+const addAuditBaseOptions = (command) => {
+    (0, shared_1.addEnvironmentOption)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.option("--index <name>", "Override the search index name (default: sitecore_master_index)");
+    command.option("--include-system", "Include /sitecore/system and platform items in the scan");
+    command.option("--limit <count>", "Maximum number of items to inspect", (v) => parseInt(v, 10));
+    command.option("--concurrency <count>", "Parallel batch fan-out for field reads + ref resolution (default 8, env SITECOREAI_HYGIENE_CONCURRENCY)", (v) => parseInt(v, 10));
+    command.option("--batch-size <count>", "Aliased GraphQL batch size per field-read query (default 50, env SITECOREAI_HYGIENE_BATCH_SIZE)", (v) => parseInt(v, 10));
+    command.option("--page-parallelism <count>", "Parallel page-windows during search enumeration (default 4, env SITECOREAI_HYGIENE_PAGE_PARALLELISM)", (v) => parseInt(v, 10));
+    command.option("--cache", "Use the on-disk field cache (keyed by itemId+updatedDate) at ~/.sitecoreai/audit-cache/");
+    command.option("--exclude <path>", "Exclude items under this path prefix. Repeat or comma-separate.", (v, prev = []) => prev.concat(v
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)), []);
+    command.option("--since <date>", "Only items updated on/after this date (ISO 8601 or YYYY-MM-DD)");
+    command.option("--owner <user>", "Filter by createdBy or updatedBy (post-fetch filter on Authoring API)");
+    command.option("--baseline", "Filter out findings present in the per-env baseline at .scai/audit-baseline-<envName>.json");
+    command.option("--output <file>", "Write the report to a file instead of stdout. Format inferred from extension (.json, .csv, .md)");
+    command.option("--format <fmt>", "Output format: json (default), csv, markdown");
+    return command;
+};
+exports.addAuditBaseOptions = addAuditBaseOptions;

package/dist/commands/audit/site-residue.d.ts

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

package/dist/commands/audit/site-residue.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditSiteResidueCommand = void 0;
+const commander_1 = require("commander");
+const site_residue_1 = require("../../hygiene/tasks/audit/site-residue");
+const shared_1 = require("./shared");
+const createAuditSiteResidueCommand = () => {
+    const command = new commander_1.Command("site-residue").description("Find SXA tenant/site folders left behind after a Sites-API delete (templates/Project, layout/Renderings/Project, media library/Project)");
+    const list = new commander_1.Command("list").description("List orphan site/tenant subtrees");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Additional root to scan on top of the SXA defaults. Repeat or comma-separate.", (value, previous = []) => previous.concat(value
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)), []);
+    list.option("--content-root <path>", "Override the content root walked when discovering active sites (default /sitecore/content)");
+    list.action(async (options) => {
+        await (0, site_residue_1.runAuditSiteResidue)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditSiteResidueCommand = createAuditSiteResidueCommand;

package/dist/commands/audit/slug-conflicts.d.ts

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

package/dist/commands/audit/slug-conflicts.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditSlugConflictsCommand = void 0;
+const commander_1 = require("commander");
+const slug_conflicts_1 = require("../../hygiene/tasks/audit/slug-conflicts");
+const shared_1 = require("./shared");
+const createAuditSlugConflictsCommand = () => {
+    const command = new commander_1.Command("slug-conflicts").description("Find siblings sharing the same item name (URL conflict)");
+    const list = new commander_1.Command("list").description("List parent paths where two or more sibling items share the same name");
+    (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("--no-case-insensitive", "Compare slugs case-sensitively (off by default — URL routing is usually case-insensitive)");
+    list.action(async (options) => {
+        await (0, slug_conflicts_1.runAuditSlugConflicts)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditSlugConflictsCommand = createAuditSlugConflictsCommand;

package/dist/commands/audit/stale-content.d.ts

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

package/dist/commands/audit/stale-content.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditStaleContentCommand = void 0;
+const commander_1 = require("commander");
+const stale_content_1 = require("../../hygiene/tasks/audit/stale-content");
+const shared_1 = require("./shared");
+const createAuditStaleContentCommand = () => {
+    const command = new commander_1.Command("stale-content").description("Find content items not updated in N days — the abandoned-content (graveyard) signal");
+    const list = new commander_1.Command("list").description("List items not updated in --not-updated-in-days, optionally excluding items currently in a workflow");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--not-updated-in-days <count>", "Threshold in days (default: 365)", (v) => parseInt(v, 10));
+    list.option("--language <code>", "Restrict to one language");
+    list.option("--no-exclude-workflow-items", "Include items currently in a non-final workflow state (off by default to keep this distinct from `audit stale-workflow`)");
+    list.action(async (options) => {
+        await (0, stale_content_1.runAuditStaleContent)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditStaleContentCommand = createAuditStaleContentCommand;

package/dist/commands/audit/stale-users.d.ts

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

package/dist/commands/audit/stale-users.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditStaleUsersCommand = void 0;
+const commander_1 = require("commander");
+const stale_users_1 = require("../../hygiene/tasks/audit/stale-users");
+const shared_1 = require("./shared");
+const createAuditStaleUsersCommand = () => {
+    const command = new commander_1.Command("stale-users").description("Find users inactive for N days (default 180)");
+    const list = new commander_1.Command("list").description("List users whose UserProfile.lastActivity is older than --not-active-days or null");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--not-active-days <count>", "Inactivity threshold in days (default 180)", (v) => parseInt(v, 10));
+    list.option("--include-admins", "Include administrators (off by default)");
+    list.option("--include-service-accounts", "Include likely service accounts (off by default; lastLoginDate doesn't reflect OAuth client-credential access)");
+    list.option("--use-activity-date", "Use UserProfile.lastActivityDate instead of lastLoginDate (broader signal)");
+    list.action(async (options) => {
+        await (0, stale_users_1.runAuditStaleUsers)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditStaleUsersCommand = createAuditStaleUsersCommand;

package/dist/commands/audit/stale-workflow.d.ts

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

package/dist/commands/audit/stale-workflow.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditStaleWorkflowCommand = void 0;
+const commander_1 = require("commander");
+const stale_workflow_1 = require("../../hygiene/tasks/audit/stale-workflow");
+const shared_1 = require("./shared");
+const createAuditStaleWorkflowCommand = () => {
+    const command = new commander_1.Command("stale-workflow").description("Find items stuck in a workflow state past a stale-after threshold");
+    const list = new commander_1.Command("list").description("List items in a non-final workflow state with no updates in N days");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--root <path>", "Content-tree root to scan (default: /sitecore/content)");
+    list.option("--days <count>", "Stale threshold in days (default: 30)", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, stale_workflow_1.runAuditStaleWorkflow)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditStaleWorkflowCommand = createAuditStaleWorkflowCommand;

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

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

package/dist/commands/audit/suite.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditSuiteCommand = void 0;
+const commander_1 = require("commander");
+const suite_run_1 = require("../../hygiene/tasks/audit/suite-run");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditSuiteCommand = () => {
+    const command = new commander_1.Command("suite").description("Run a YAML-defined audit pipeline (codified hygiene policy)");
+    const run = new commander_1.Command("run").description("Execute a suite file");
+    (0, shared_2.addAuditBaseOptions)(run);
+    run.requiredOption("--file <path>", "Path to the audit-suite YAML file");
+    run.option("--only <audits>", "Comma-separated subset of suite audits to run", shared_1.collectList, []);
+    run.addHelpText("after", "\nSuite file format (YAML):\n" +
+        "  version: 1\n" +
+        "  name: monthly-hygiene\n" +
+        "  audits:\n" +
+        "    - name: broken-links\n" +
+        "      options: { root: /sitecore/content/MySite, limit: 1000 }\n" +
+        "    - name: duplicates\n" +
+        "      options: { min-group-size: 3 }\n" +
+        "  output: { format: markdown, path: ./reports/{date}.md }\n" +
+        "  baseline: { enabled: true }\n" +
+        "\nOutput-path tokens: {date}, {datetime}, {env}, {suite}.\n");
+    run.action(async (options) => {
+        await (0, suite_run_1.runAuditSuiteRun)(options);
+    });
+    command.addCommand(run);
+    return command;
+};
+exports.createAuditSuiteCommand = createAuditSuiteCommand;

package/dist/commands/audit/template-dependencies.d.ts

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

package/dist/commands/audit/template-dependencies.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditTemplateDependenciesCommand = void 0;
+const commander_1 = require("commander");
+const template_dependencies_1 = require("../../hygiene/tasks/audit/template-dependencies");
+const shared_1 = require("./shared");
+const createAuditTemplateDependenciesCommand = () => {
+    const command = new commander_1.Command("template-dependencies").description("List every item that references a given template — primary template, base template, insert options, or branch source");
+    const list = new commander_1.Command("list").description("List inbound references to a template");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.requiredOption("--template-id <guid>", "Template item ID to find references for (any GUID form)");
+    list.option("--skip <kind>", "Skip a reference kind: primary-template, base-template, insert-options, branch-source, datasource-template. Repeat or comma-separate.", (v, prev = []) => prev.concat(v
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)), []);
+    list.action(async (options) => {
+        await (0, template_dependencies_1.runAuditTemplateDependencies)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditTemplateDependenciesCommand = createAuditTemplateDependenciesCommand;

package/dist/commands/audit/translation-coverage.d.ts

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

package/dist/commands/audit/translation-coverage.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditTranslationCoverageCommand = void 0;
+const commander_1 = require("commander");
+const translation_coverage_1 = require("../../hygiene/tasks/audit/translation-coverage");
+const shared_1 = require("../shared");
+const shared_2 = require("./shared");
+const createAuditTranslationCoverageCommand = () => {
+    const command = new commander_1.Command("translation-coverage").description("Measure translation coverage between a reference and target language(s)");
+    const list = new commander_1.Command("list").description("Compare item sets between --reference-language and each --target-language");
+    (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 to compare (e.g. fr,de,es)", shared_1.collectList, []);
+    list.option("--reference-language <code>", "Reference (source) language (default: en)");
+    list.option("--min-coverage-percent <pct>", "Only flag languages below this coverage % (default 0 = report all)", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, translation_coverage_1.runAuditTranslationCoverage)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditTranslationCoverageCommand = createAuditTranslationCoverageCommand;

package/dist/commands/audit/unused-media.d.ts

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

package/dist/commands/audit/unused-media.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuditUnusedMediaCommand = void 0;
+const commander_1 = require("commander");
+const unused_media_1 = require("../../hygiene/tasks/audit/unused-media");
+const shared_1 = require("./shared");
+const createAuditUnusedMediaCommand = () => {
+    const command = new commander_1.Command("unused-media").description("Find media library items with zero references from content");
+    const list = new commander_1.Command("list").description("List media items that aren't referenced by any content");
+    (0, shared_1.addAuditBaseOptions)(list);
+    list.option("--media-root <path>", "Media library root to scan (default: /sitecore/media library)");
+    list.option("--reference-root <path>", "Root under which media references are searched (default: /sitecore/content)");
+    list.option("--media-limit <count>", "Cap on the number of media items inspected", (v) => parseInt(v, 10));
+    list.option("--reference-limit <count>", "Cap on the number of reference-side items inspected", (v) => parseInt(v, 10));
+    list.action(async (options) => {
+        await (0, unused_media_1.runAuditUnusedMedia)(options);
+    });
+    command.addCommand(list);
+    return command;
+};
+exports.createAuditUnusedMediaCommand = createAuditUnusedMediaCommand;