@sitecoreai-labs/sitecoreai-cli 0.0.4

package/dist/config/modules.js

@@ -0,0 +1,152 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSerializationModules = exports.normalizeModuleConfiguration = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../shared/errors");
+const item_path_1 = require("../serialization/item-path");
+const tree_spec_1 = require("../serialization/tree-spec");
+const validation_1 = require("./validation");
+const resolveScope = (scope) => {
+    switch ((scope ?? "").toLowerCase()) {
+        case "singleitem":
+            return tree_spec_1.TreeScope.SingleItem;
+        case "itemandchildren":
+            return tree_spec_1.TreeScope.ItemAndChildren;
+        case "descendantsonly":
+            return tree_spec_1.TreeScope.DescendantsOnly;
+        case "itemanddescendants":
+        default:
+            return tree_spec_1.TreeScope.ItemAndDescendants;
+    }
+};
+const resolveRuleScope = (scope) => {
+    if (!scope) {
+        return undefined;
+    }
+    switch (scope.toLowerCase()) {
+        case "ignored":
+            return tree_spec_1.TreeRuleScope.Ignored;
+        case "singleitem":
+            return tree_spec_1.TreeRuleScope.SingleItem;
+        case "itemandchildren":
+            return tree_spec_1.TreeRuleScope.ItemAndChildren;
+        case "itemanddescendants":
+            return tree_spec_1.TreeRuleScope.ItemAndDescendants;
+        default:
+            return undefined;
+    }
+};
+const resolveAllowedPushOperations = (value) => {
+    switch ((value ?? "").toLowerCase()) {
+        case "createonly":
+            return tree_spec_1.AllowedPushOperations.CreateOnly;
+        case "createandupdate":
+            return tree_spec_1.AllowedPushOperations.CreateAndUpdate;
+        case "createupdateanddelete":
+        default:
+            return tree_spec_1.AllowedPushOperations.CreateUpdateAndDelete;
+    }
+};
+const resolveModuleItemsPath = (moduleConfig, modulePath, rootConfig) => {
+    const raw = moduleConfig.items.path ?? rootConfig.serialization.defaultModuleRelativeSerializationPath;
+    if (raw.startsWith("~/")) {
+        const rooted = raw.slice(2).replace("$(module)", moduleConfig.namespace ?? "module");
+        return node_path_1.default.join(node_path_1.default.dirname(rootConfig.physicalPath), rooted);
+    }
+    return node_path_1.default.join(node_path_1.default.dirname(modulePath), raw);
+};
+const normalizeFieldFilters = (filters) => (filters ?? []).map((filter) => ({
+    fieldId: filter.fieldId ?? filter.FieldId ?? "",
+    description: filter.description,
+}));
+const normalizeModuleConfiguration = (raw, moduleFile, rootConfig) => {
+    const moduleConfig = {
+        namespace: raw.namespace ?? "",
+        description: raw.description,
+        references: raw.references ?? [],
+        items: {
+            path: raw.items?.path,
+            includes: [],
+            excludedFields: normalizeFieldFilters(raw.items?.excludedFields),
+        },
+        roles: (raw.roles ?? []),
+        users: (raw.users ?? []),
+        tags: raw.tags ?? [],
+        sourceIdentifier: moduleFile,
+    };
+    const basePath = resolveModuleItemsPath(moduleConfig, moduleFile, rootConfig);
+    for (const includeSpec of raw.items?.includes ?? []) {
+        const include = includeSpec;
+        if (!include.path || !include.name) {
+            continue;
+        }
+        const subtree = new tree_spec_1.FilesystemTreeSpec();
+        subtree.name = include.name;
+        subtree.database = include.database ?? "master";
+        subtree.path = item_path_1.ItemPath.fromPathString(include.path);
+        subtree.scope = resolveScope(include.scope);
+        subtree.allowedPushOperations = resolveAllowedPushOperations(include.allowedPushOperations);
+        subtree.maxRelativePathLength = include.maxRelativePathLength;
+        subtree.physicalPath = node_path_1.default.join(basePath, include.name);
+        subtree.rules = (include.rules ?? []).map((rule) => {
+            const treeRule = new tree_spec_1.FilesystemTreeSpecRule();
+            treeRule.path = (0, tree_spec_1.parseItemPathMatch)(rule.path);
+            treeRule.scope = resolveRuleScope(rule.scope);
+            treeRule.allowedPushOperations = rule.allowedPushOperations
+                ? resolveAllowedPushOperations(rule.allowedPushOperations)
+                : undefined;
+            treeRule.alias = rule.alias;
+            return treeRule;
+        });
+        moduleConfig.items.includes.push(subtree);
+    }
+    return moduleConfig;
+};
+exports.normalizeModuleConfiguration = normalizeModuleConfiguration;
+const readSerializationModules = async (rootConfig, include, exclude) => {
+    if (!rootConfig.modules.length) {
+        throw (0, errors_1.createCliError)("Root configuration does not contain any module path definitions.", "CONFIG_INVALID");
+    }
+    const rootDir = node_path_1.default.dirname(rootConfig.physicalPath);
+    const moduleFiles = await (0, fast_glob_1.default)(rootConfig.modules, {
+        cwd: rootDir,
+        absolute: true,
+        onlyFiles: true,
+    });
+    const modules = [];
+    for (const moduleFile of moduleFiles) {
+        const raw = (0, validation_1.readJsonFile)(moduleFile);
+        const valid = (0, validation_1.validateModuleConfig)(raw);
+        if (!valid) {
+            const details = validation_1.validateModuleConfig.errors
+                ? (0, validation_1.formatValidationErrors)(validation_1.validateModuleConfig.errors)
+                : undefined;
+            throw (0, errors_1.createCliError)(`Invalid module configuration at ${moduleFile}.`, "CONFIG_INVALID", {
+                hint: "Fix the module JSON to match the serialization module schema.",
+                details,
+            });
+        }
+        modules.push((0, exports.normalizeModuleConfiguration)(raw, moduleFile, rootConfig));
+    }
+    const filtered = modules.filter((module) => {
+        if (include && include.length > 0) {
+            const matches = include.some((pattern) => module.namespace.toLowerCase().includes(pattern.toLowerCase()));
+            if (!matches) {
+                return false;
+            }
+        }
+        if (exclude && exclude.length > 0) {
+            const excluded = exclude.some((pattern) => module.namespace.toLowerCase().includes(pattern.toLowerCase()));
+            if (excluded) {
+                return false;
+            }
+        }
+        return true;
+    });
+    return filtered;
+};
+exports.readSerializationModules = readSerializationModules;

package/dist/config/paths.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveRootConfigurationPath: (currentPath: string) => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,4BAA4B,GAAI,aAAa,MAAM,KAAG,MAqClE,CAAC"}

package/dist/config/paths.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRootConfigurationPath = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const errors_1 = require("../shared/errors");
+const resolveRootConfigurationPath = (currentPath) => {
+    const stat = node_fs_1.default.existsSync(currentPath) ? node_fs_1.default.statSync(currentPath) : null;
+    // `--config <file>`: use the file directly. Lets users keep multiple
+    // configs side-by-side (sitecoreai.dev.json, sitecoreai.staging.json)
+    // and pick one per invocation. The file doesn't need to be named
+    // `sitecoreai.cli.json` — the schema is what matters, not the name.
+    if (stat?.isFile()) {
+        return node_path_1.default.resolve(currentPath);
+    }
+    // `--config <dir>` (or no flag): walk upward looking for the
+    // standard `sitecoreai.cli.json` filename.
+    const startDir = currentPath;
+    let dir = node_path_1.default.resolve(startDir);
+    while (true) {
+        const candidate = node_path_1.default.join(dir, "sitecoreai.cli.json");
+        if (node_fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = node_path_1.default.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    const cwd = process.cwd();
+    throw (0, errors_1.createCliError)(`Couldn't resolve a root configuration file (sitecoreai.cli.json) from ${cwd} or any parent directory.`, "CONFIG_NOT_FOUND", {
+        hint: "Run 'scai init' to create a configuration file, or pass --config <path> to a directory or a config file.",
+    });
+};
+exports.resolveRootConfigurationPath = resolveRootConfigurationPath;

package/dist/config/root-config.d.ts

@@ -0,0 +1,10 @@
+import { EnvironmentConfiguration, RootConfiguration, RootConfigurationFile } from "./types";
+export declare const readRootConfigurationFile: (configPath: string) => {
+    rootPath: string;
+    rootDir: string;
+    config: RootConfigurationFile;
+};
+export declare const writeRootConfigurationFile: (configPath: string, config: RootConfigurationFile) => void;
+export declare const mergeEnvironmentConfigurations: (primary?: Record<string, EnvironmentConfiguration>, fallback?: Record<string, EnvironmentConfiguration>) => Record<string, EnvironmentConfiguration>;
+export declare const readRootConfiguration: (configPath: string, activeEnvironmentName?: string) => RootConfiguration;
+//# sourceMappingURL=root-config.d.ts.map

package/dist/config/root-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-config.d.ts","sourceRoot":"","sources":["../../src/config/root-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAKjB,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,KACjB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAwBpE,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,YAAY,MAAM,EAClB,QAAQ,qBAAqB,KAC5B,IAIF,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,UAAU,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAClD,WAAW,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,KAClD,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAGxC,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,EAClB,wBAAwB,MAAM,KAC7B,iBAiCF,CAAC"}

package/dist/config/root-config.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRootConfiguration = exports.mergeEnvironmentConfigurations = exports.writeRootConfigurationFile = exports.readRootConfigurationFile = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../shared/errors");
+const types_1 = require("./types");
+const env_overrides_1 = require("./env-overrides");
+const validation_1 = require("./validation");
+const paths_1 = require("./paths");
+const readRootConfigurationFile = (configPath) => {
+    const rootPath = (0, paths_1.resolveRootConfigurationPath)(configPath);
+    const rootDir = node_path_1.default.dirname(rootPath);
+    let rootJson;
+    try {
+        rootJson = (0, validation_1.readJsonFile)(rootPath);
+    }
+    catch (error) {
+        const details = error instanceof Error && error.message ? [error.message] : undefined;
+        throw (0, errors_1.createCliError)(`Invalid configuration file at ${rootPath}.`, "CONFIG_INVALID", {
+            hint: "Fix the configuration or re-run 'scai init' to regenerate it.",
+            details,
+        });
+    }
+    const valid = (0, validation_1.validateRootConfig)(rootJson);
+    if (!valid) {
+        const details = validation_1.validateRootConfig.errors
+            ? (0, validation_1.formatValidationErrors)(validation_1.validateRootConfig.errors)
+            : undefined;
+        throw (0, errors_1.createCliError)(`Invalid configuration file at ${rootPath}.`, "CONFIG_INVALID", {
+            hint: "Fix the configuration or re-run 'scai init' to regenerate it.",
+            details,
+        });
+    }
+    return { rootPath, rootDir, config: rootJson ?? {} };
+};
+exports.readRootConfigurationFile = readRootConfigurationFile;
+const writeRootConfigurationFile = (configPath, config) => {
+    const rootPath = (0, paths_1.resolveRootConfigurationPath)(configPath);
+    const sanitized = (0, env_overrides_1.stripAuthenticationTokensFromConfig)(config);
+    node_fs_1.default.writeFileSync(rootPath, JSON.stringify(sanitized, null, 2), "utf8");
+};
+exports.writeRootConfigurationFile = writeRootConfigurationFile;
+const mergeEnvironmentConfigurations = (primary, fallback) => ({
+    ...(fallback ?? {}),
+    ...(primary ?? {}),
+});
+exports.mergeEnvironmentConfigurations = mergeEnvironmentConfigurations;
+const readRootConfiguration = (configPath, activeEnvironmentName) => {
+    const { rootPath, config: rootJson } = (0, exports.readRootConfigurationFile)(configPath);
+    const settings = {
+        ...types_1.DEFAULT_SETTINGS,
+        ...(rootJson.settings ?? {}),
+    };
+    const environments = resolveEnvironmentReferences(rootJson.envProfiles ?? {});
+    const envWithOverrides = {};
+    for (const [name, env] of Object.entries(environments)) {
+        const includeGlobal = activeEnvironmentName
+            ? name.toLowerCase() === activeEnvironmentName.toLowerCase()
+            : false;
+        envWithOverrides[name] = {
+            ...(0, env_overrides_1.applyEnvOverrides)(name, flattenRecipeRoots(name, env), includeGlobal),
+            name,
+            cacheAuthenticationToken: settings.cacheAuthenticationToken,
+        };
+    }
+    return {
+        modules: rootJson.modules ?? [],
+        serialization: {
+            ...types_1.DEFAULT_SERIALIZATION,
+            ...(rootJson.serialization ?? {}),
+            excludedFields: rootJson.serialization?.excludedFields ?? types_1.DEFAULT_SERIALIZATION.excludedFields,
+        },
+        settings,
+        environments: envWithOverrides,
+        physicalPath: rootPath,
+        defaultEnvironment: rootJson.defaultEnvProfile ?? types_1.DEFAULT_ENVIRONMENT,
+        recipes: rootJson.recipes ?? types_1.DEFAULT_RECIPES_GLOBS,
+    };
+};
+exports.readRootConfiguration = readRootConfiguration;
+/**
+ * Pairing of nested-form key (under `recipeRoots`) and its flat-form
+ * counterpart on `EnvironmentConfiguration`. The flatten step copies
+ * each nested entry into the matching flat field.
+ */
+const RECIPE_ROOT_PAIRS = [
+    ["templates", "templatesRoot"],
+    ["renderings", "renderingsRoot"],
+    ["components", "componentsRoot"],
+    ["contentModels", "contentModelsRoot"],
+    ["partialDesigns", "partialDesignsRoot"],
+    ["pageDesigns", "pageDesignsRoot"],
+    ["contentItems", "contentItemsRoot"],
+    ["headlessVariants", "headlessVariantsRoot"],
+    ["availableRenderings", "availableRenderingsRoot"],
+    ["enumerations", "enumerationsRoot"],
+    ["placeholderSettings", "placeholderSettingsRoots"],
+];
+/**
+ * Flatten `env.recipeRoots.<x>` entries into the matching flat
+ * `env.<x>Root` fields so internal consumers see one shape. When the
+ * same field is set both nested and flat, **nested wins** (preferred
+ * form takes precedence for migrating configs) and a one-line warning
+ * fires so the operator can pick a side.
+ */
+const flattenRecipeRoots = (envName, env) => {
+    if (!env.recipeRoots) {
+        return env;
+    }
+    const flattened = { ...env };
+    const collisions = [];
+    for (const [nestedKey, flatKey] of RECIPE_ROOT_PAIRS) {
+        const nestedValue = env.recipeRoots[nestedKey];
+        if (nestedValue === undefined) {
+            continue;
+        }
+        if (env[flatKey] !== undefined) {
+            collisions.push(`${flatKey}/recipeRoots.${nestedKey}`);
+        }
+        flattened[flatKey] = nestedValue;
+    }
+    if (collisions.length > 0) {
+        process.stderr.write(`Warning: env profile '${envName}' sets these roots both flat and under recipeRoots: ` +
+            `${collisions.join(", ")}. recipeRoots wins. Pick one form.\n`);
+    }
+    return flattened;
+};
+const resolveEnvironmentReferences = (environments) => {
+    const resolving = new Set();
+    const resolveOne = (name) => {
+        if (resolving.has(name)) {
+            throw (0, errors_1.createCliError)(`Environment references are circular for '${name}'.`, "CONFIG_INVALID", {
+                hint: "Remove circular refs in envProfiles.",
+            });
+        }
+        const current = environments[name];
+        if (!current) {
+            throw (0, errors_1.createCliError)(`Referenced environment '${name}' was not found.`, "CONFIG_INVALID", {
+                hint: "Update envProfiles to reference a valid environment name.",
+            });
+        }
+        if (!current.ref) {
+            return { ...current };
+        }
+        resolving.add(name);
+        const base = resolveOne(current.ref);
+        resolving.delete(name);
+        return { ...base, ...current };
+    };
+    const resolved = {};
+    for (const name of Object.keys(environments)) {
+        resolved[name] = resolveOne(name);
+    }
+    return resolved;
+};

package/dist/config/schema.json

@@ -0,0 +1,278 @@
+{
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "$id": "https://schemas.sitecoreai.dev/v1/sitecoreai.cli.json",
+    "title": "SitecoreAI CLI Root Configuration",
+    "type": "object",
+    "description": "Defines the Sitecore AI CLI root configuration",
+    "additionalProperties": false,
+    "required": ["modules"],
+    "properties": {
+        "$schema": { "type": "string" },
+        "defaultEnvProfile": {
+            "type": "string",
+            "description": "Default environment profile to fetch or push data to"
+        },
+        "envProfiles": {
+            "type": "object",
+            "description": "Named environment profiles used by this CLI",
+            "additionalProperties": {
+                "$ref": "#/definitions/EnvironmentConfiguration"
+            }
+        },
+        "modules": {
+            "type": "array",
+            "description": "Sitecore module file resolution globs",
+            "minItems": 1,
+            "items": { "type": "string" }
+        },
+        "recipes": {
+            "type": "array",
+            "description": "Globs locating .recipe.ts / .recipe.json files for `scai recipe compile|plan|push`. Defaults to `recipes/**/*.recipe.ts` if unset.",
+            "items": { "type": "string" }
+        },
+        "serialization": {
+            "description": "Global item serialization default settings",
+            "oneOf": [{ "$ref": "#/definitions/SerializationRootConfiguration" }]
+        },
+        "settings": {
+            "description": "Cli settings",
+            "oneOf": [{ "$ref": "#/definitions/Settings" }]
+        }
+    },
+    "definitions": {
+        "SerializationRootConfiguration": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "defaultMaxRelativeItemPathLength": {
+                    "type": "integer",
+                    "description": "Max relative item path length to serialize before considering path too long (and requiring aliasing to shorten).\nOverridable on a per-module basis; this is the default when it is unspecified.",
+                    "format": "int32",
+                    "default": 120
+                },
+                "defaultModuleRelativeSerializationPath": {
+                    "type": "string",
+                    "description": "The default relative physical path from a module file where serialized items for that module will be stored.\nFor example given module /c/foo/bar.module.json, and default '/serialization/items' path,\nthe serialized items for bar would be stored at /c/foo/bar/serialization/items.\nPrefix the path with ~/ for a root configuration relative path instead of a module-relative path.\nUse '$(module)' to insert the module name when using a root relative path.\nOverridable on a per-module basis; this is the default when it is unspecified.",
+                    "default": "serialization"
+                },
+                "removeOrphansForRoles": {
+                    "type": "boolean",
+                    "description": "Specifies remove orphans functionality for roles serialization",
+                    "default": true
+                },
+                "removeOrphansForUsers": {
+                    "type": "boolean",
+                    "description": "Specifies remove orphans functionality for users serialization",
+                    "default": true
+                },
+                "continueOnItemFailure": {
+                    "type": "boolean",
+                    "description": "Specifies behavior when item synchronization fails",
+                    "default": false
+                },
+                "excludedFields": {
+                    "type": "array",
+                    "description": "Configure base fields filter",
+                    "items": { "$ref": "#/definitions/FieldFilter" }
+                }
+            }
+        },
+        "FieldFilter": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "fieldId": { "type": "string" },
+                "description": { "type": "string" }
+            }
+        },
+        "Settings": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "telemetryEnabled": {
+                    "type": "boolean",
+                    "description": "Determines if telemetry is enabled in cli.",
+                    "default": false
+                },
+                "cacheAuthenticationToken": {
+                    "type": "boolean",
+                    "description": "Determines if the CLI should cache CM access/refresh tokens in the OS keychain.",
+                    "default": true
+                },
+                "versionComparisonEnabled": {
+                    "type": "boolean",
+                    "description": "Determines if CLI\\SMS version comparison is enabled.",
+                    "default": true
+                },
+                "apiClientTimeoutInMinutes": {
+                    "type": "integer",
+                    "description": "Determines timeout for Sitecore Api client.",
+                    "format": "int32",
+                    "minimum": 1,
+                    "maximum": 60,
+                    "default": 5
+                }
+            }
+        },
+        "EnvironmentConfiguration": {
+            "type": "object",
+            "description": "Configures a named Sitecore environment profile",
+            "additionalProperties": false,
+            "properties": {
+                "name": { "type": "string", "description": "Optional display name for the environment" },
+                "ref": { "type": "string", "description": "Name of the environment to inherit from" },
+                "organizationId": { "type": "string", "description": "Sitecore organization ID" },
+                "tenantId": { "type": "string", "description": "Sitecore tenant ID" },
+                "projectId": { "type": "string", "description": "Sitecore project ID" },
+                "environmentId": { "type": "string", "description": "Sitecore environment ID" },
+                "environmentType": {
+                    "type": "string",
+                    "description": "Environment type (cm or eh)",
+                    "enum": ["cm", "eh"]
+                },
+                "allowWrite": {
+                    "type": "boolean",
+                    "description": "Whether writing data to this endpoint is allowed (i.e. to prevent accidental writes to production)"
+                },
+                "host": {
+                    "type": "string",
+                    "description": "Base URL to the Sitecore instance to connect to (i.e. http://{my-sitecore-instance}.sitecorecloud.io)",
+                    "format": "uri",
+                    "minLength": 1
+                },
+                "authority": {
+                    "type": "string",
+                    "description": "Base URL to SitecoreAI identity authority (e.g. https://auth.sitecorecloud.io)",
+                    "format": "uri",
+                    "minLength": 1
+                },
+                "useClientCredentials": {
+                    "type": ["boolean", "null"],
+                    "description": "If true, use client credentials (client ID and secret) instead of interactive device login. Recommended for CI."
+                },
+                "accessToken": {
+                    "type": "string",
+                    "description": "OAuth access token for this endpoint. Cached in the OS keychain when enabled."
+                },
+                "refreshToken": {
+                    "type": "string",
+                    "description": "OAuth refresh token for this endpoint. Cached in the OS keychain when enabled."
+                },
+                "refreshTokenParameters": {
+                    "type": "object",
+                    "description": "OAuth refresh parameters for this endpoint (set manually if needed)",
+                    "additionalProperties": { "type": "string" }
+                },
+                "expiresIn": {
+                    "type": ["integer", "null"],
+                    "description": "Preserves access token lifetime. Set during the login operation. Related to LastUpdated property. System use only.",
+                    "format": "int32"
+                },
+                "lastUpdated": {
+                    "type": ["null", "string"],
+                    "description": "Preserve date and time when environment was updated. System use only.",
+                    "format": "date-time"
+                },
+                "deployToken": {
+                    "type": "string",
+                    "description": "SitecoreAI access token (Deploy + CM/admin scopes). Cached in the OS keychain."
+                },
+                "deployTokenExpiresIn": {
+                    "type": ["integer", "null"],
+                    "description": "Deploy token lifetime in seconds",
+                    "format": "int32"
+                },
+                "deployTokenLastUpdated": {
+                    "type": ["null", "string"],
+                    "description": "Last time the deploy token was updated",
+                    "format": "date-time"
+                },
+                "editingHostEnvironmentIds": {
+                    "type": "array",
+                    "description": "Editing host environment IDs associated with this CM environment",
+                    "items": { "type": "string" }
+                },
+                "clientId": { "type": "string", "description": "OAuth client ID for this endpoint" },
+                "clientSecret": {
+                    "type": "string",
+                    "description": "OAuth client secret for this endpoint (when useClientCredentials is true). Prefer environment variables."
+                },
+                "variables": {
+                    "type": "object",
+                    "description": "Defines variables that are specific to this environment. Variables defined here override any definitions in the root configuration for this environment.",
+                    "additionalProperties": { "type": "string" }
+                },
+                "audience": {
+                    "type": "string",
+                    "description": "The unique identifier of the audience for an issued token"
+                },
+                "templatesRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates template items (e.g. /sitecore/templates/Project/<site>/Components). Tenant-specific. Used as fallback when --templates-root is not passed."
+                },
+                "componentsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates component template items in the per-site folder layout (`<componentsRoot>/<section>/<Component>`). When unset, the compiler falls back to `templatesRoot` and emits the legacy flat layout. Used as fallback when --components-root is not passed."
+                },
+                "contentModelsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates content-template items (`<contentModelsRoot>/<group>/<name>` when grouped, flat otherwise). When unset, content templates fall back to `templatesRoot` and land mixed in with components. Used as fallback when --content-models-root is not passed."
+                },
+                "renderingsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates rendering items (e.g. /sitecore/layout/Renderings/Project/<site>). Tenant-specific. Used as fallback when --renderings-root is not passed."
+                },
+                "partialDesignsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates partial-design items (e.g. /sitecore/content/<site>/Presentation/Partial Designs). Required for PartialDesignRecipe compilation."
+                },
+                "pageDesignsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates page-design items (e.g. /sitecore/content/<site>/Presentation/Page Designs). Required for PageDesignRecipe compilation; also seeds crossRecipeRefs for the cross-recipe TemplatesMapping aggregate."
+                },
+                "contentItemsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates shared content items (e.g. /sitecore/content/<site>/Data). Required for ContentItemRecipe compilation."
+                },
+                "headlessVariantsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates SXA Headless rendering variants (e.g. /sitecore/content/<siteCollection>/<site>/Presentation/Headless Variants). Required when any recipe in the set declares variants."
+                },
+                "availableRenderingsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates SXA Available Renderings section items (e.g. /sitecore/content/<siteCollection>/<site>/Presentation/Available Renderings). One section per `recipe.section` is emitted with all renderings in that section listed in the Renderings field."
+                },
+                "enumerationsRoot": {
+                    "type": "string",
+                    "description": "Sitecore parent path under which `scai recipe compile|push` creates EnumerationRecipe items (e.g. /sitecore/content/<siteCollection>/<site>/Presentation/Enumerations). Each enum lands as `<enumerationsRoot>/<EnumName>` with one child item per declared value. Required for EnumerationRecipe compilation, and for any recipe whose fields carry `sitecore.enumHandle`."
+                },
+                "placeholderSettingsRoots": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Sitecore content-tree paths to walk when resolving recipe-declared `placeholders` to Placeholder Settings items (matched by their `Placeholder Key` field). Typically the per-site Presentation/Placeholder Settings AND the Layout/Placeholder Settings/Project/<site> path."
+                },
+                "recipeRoots": {
+                    "type": "object",
+                    "description": "Preferred nested form of the *Root fields. Flattened into the matching flat fields at config-load time (recipeRoots wins when both are set; a warning fires).",
+                    "additionalProperties": false,
+                    "properties": {
+                        "templates": { "type": "string" },
+                        "renderings": { "type": "string" },
+                        "components": { "type": "string" },
+                        "contentModels": { "type": "string" },
+                        "partialDesigns": { "type": "string" },
+                        "pageDesigns": { "type": "string" },
+                        "contentItems": { "type": "string" },
+                        "headlessVariants": { "type": "string" },
+                        "availableRenderings": { "type": "string" },
+                        "enumerations": { "type": "string" },
+                        "placeholderSettings": {
+                            "type": "array",
+                            "items": { "type": "string" }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}