@sitecoreai-labs/sitecoreai-cli 0.0.4

package/dist/recipe/index.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Public recipe API — `import { ... } from "@sitecoreai-labs/sitecoreai-cli/recipe"`.
+ *
+ * The registry (and any other consumer) imports recipe types and the
+ * compiler from this entry. Internal CLI plumbing (config loading,
+ * commander wiring, GraphQL transport bound to scai's environment shape)
+ * stays in `src/recipe/{tasks,api/graphql,api/authoring-client,io}.ts`
+ * and is NOT re-exported here.
+ *
+ * Stability contract: the surface in this file is the public contract.
+ * Anything not exported here is internal and may move between scai
+ * versions without notice.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NAMESPACE_ROOT = exports.NAMESPACE_RENDERING = exports.NAMESPACE_PROJECT = exports.NAMESPACE_PARTIAL_DESIGN = exports.NAMESPACE_PAGE_DESIGN = exports.NAMESPACE_CONTENT_ITEM = exports.encodeTemplatesMapping = exports.emitLayoutXml = exports.TEMPLATES_MAPPING_AGGREGATE_HANDLE = exports.compileSiteTemplateRecipe = exports.compileSiteRecipe = exports.compileSectionDefinitionRecipe = exports.compileRecipeSet = exports.compileRecipe = exports.compilePartialDesignRecipe = exports.compileParametersTemplateRecipe = exports.compilePageDesignRecipe = exports.compileContentTemplateRecipe = exports.compileContentItemRecipe = exports.compileComponentTemplateRecipe = exports.sitecoreFieldTypeLabel = exports.defaultSitecoreFieldType = exports.SitecoreFieldTypeSchema = exports.SITECORE_FIELD_TYPES = exports.FieldShapeSchema = exports.FIELD_SHAPES = exports.SitecoreFieldAugmentSchema = exports.SiteTemplateTaxonomyEntrySchema = exports.SiteTemplateRecipeSchema = exports.SiteTemplateDictionaryEntrySchema = exports.SiteRecipeSchema = exports.SiteGroupingSchema = exports.SectionDefinitionRecipeSchema = exports.RenderingVariantDefinitionSchema = exports.RenderingDatasourceLocationSchema = exports.RecipeDatasourceSchema = exports.RecipeSchema = exports.RecipeMetaSchema = exports.PlaceholderDefinitionSchema = exports.PartialDesignRecipeSchema = exports.ParametersTemplateRecipeSchema = exports.ParamDefinitionSchema = exports.PageDesignRecipeSchema = exports.LayoutSchema = exports.FieldDefinitionSchema = exports.ContentTemplateRecipeSchema = exports.ContentItemRecipeSchema = exports.ContentFieldValueSchema = exports.ComponentTemplateRecipeSchema = exports.ComponentPlacementSchema = void 0;
+exports.STANDARD_TEMPLATE_ID = exports.SITECORE_TEMPLATES = exports.SITE_TEMPLATE_FIELDS = exports.SITE_FIELDS = exports.SECTION_DEFINITION_FIELDS = exports.RENDERING_FIELDS = exports.LAYOUT_FIELDS = exports.DEFAULT_VERSION = exports.DEFAULT_LANGUAGE = exports.DEFAULT_ICON = exports.DEFAULT_DEVICE_ID = exports.COMPOSITION_FIELDS = exports.SetStandardValuesOpSchema = exports.SetFieldOpSchema = exports.SetBaseTemplatesOpSchema = exports.RefValueSchema = exports.PushPolicySchema = exports.OperationSchema = exports.OperationIrSchema = exports.FieldValueSchema = exports.CreateItemOpSchema = exports.AppendToMultiListOpSchema = exports.variantsFolderId = exports.variantId = exports.templateId = exports.standardValuesId = exports.siteDataFolderId = exports.siteBranchId = exports.sectionId = exports.sectionFolderId = exports.sectionDefinitionId = exports.renderingsSectionFolderId = exports.renderingId = exports.presentationParametersBucketId = exports.partialDesignId = exports.paramsTemplateId = exports.paramsSectionId = exports.paramsFieldId = exports.pageDesignId = exports.fieldId = exports.datasourceId = exports.contentModelsGroupFolderId = exports.contentItemId = exports.componentFoldersBucketId = exports.componentFolderTemplateId = exports.componentFolderStandardValuesId = exports.PAGE_DESIGNS_ROOT_REF_KEY = exports.NAMESPACE_TEMPLATE = exports.NAMESPACE_SITE_BRANCH = exports.NAMESPACE_SECTION_DEFINITION = void 0;
+exports.validateRecipeSetOrThrow = exports.validateRecipeSet = exports.isValid = exports.formatValidationErrors = exports.purposeForRecipe = exports.policyForOp = exports.policyFor = exports.defaultPolicyForRecipe = exports.sourceFieldsNeedHandleResolution = exports.renderSourceFields = exports.renderRefValue = exports.executeIr = exports.buildPlan = exports.TEMPLATE_FIELD_FIELDS = exports.SYSTEM_FIELDS = void 0;
+// Recipe author surface ---------------------------------------------------
+var recipe_1 = require("./schema/recipe");
+Object.defineProperty(exports, "ComponentPlacementSchema", { enumerable: true, get: function () { return recipe_1.ComponentPlacementSchema; } });
+Object.defineProperty(exports, "ComponentTemplateRecipeSchema", { enumerable: true, get: function () { return recipe_1.ComponentTemplateRecipeSchema; } });
+Object.defineProperty(exports, "ContentFieldValueSchema", { enumerable: true, get: function () { return recipe_1.ContentFieldValueSchema; } });
+Object.defineProperty(exports, "ContentItemRecipeSchema", { enumerable: true, get: function () { return recipe_1.ContentItemRecipeSchema; } });
+Object.defineProperty(exports, "ContentTemplateRecipeSchema", { enumerable: true, get: function () { return recipe_1.ContentTemplateRecipeSchema; } });
+Object.defineProperty(exports, "FieldDefinitionSchema", { enumerable: true, get: function () { return recipe_1.FieldDefinitionSchema; } });
+Object.defineProperty(exports, "LayoutSchema", { enumerable: true, get: function () { return recipe_1.LayoutSchema; } });
+Object.defineProperty(exports, "PageDesignRecipeSchema", { enumerable: true, get: function () { return recipe_1.PageDesignRecipeSchema; } });
+Object.defineProperty(exports, "ParamDefinitionSchema", { enumerable: true, get: function () { return recipe_1.ParamDefinitionSchema; } });
+Object.defineProperty(exports, "ParametersTemplateRecipeSchema", { enumerable: true, get: function () { return recipe_1.ParametersTemplateRecipeSchema; } });
+Object.defineProperty(exports, "PartialDesignRecipeSchema", { enumerable: true, get: function () { return recipe_1.PartialDesignRecipeSchema; } });
+Object.defineProperty(exports, "PlaceholderDefinitionSchema", { enumerable: true, get: function () { return recipe_1.PlaceholderDefinitionSchema; } });
+Object.defineProperty(exports, "RecipeMetaSchema", { enumerable: true, get: function () { return recipe_1.RecipeMetaSchema; } });
+Object.defineProperty(exports, "RecipeSchema", { enumerable: true, get: function () { return recipe_1.RecipeSchema; } });
+Object.defineProperty(exports, "RecipeDatasourceSchema", { enumerable: true, get: function () { return recipe_1.RecipeDatasourceSchema; } });
+Object.defineProperty(exports, "RenderingDatasourceLocationSchema", { enumerable: true, get: function () { return recipe_1.RenderingDatasourceLocationSchema; } });
+Object.defineProperty(exports, "RenderingVariantDefinitionSchema", { enumerable: true, get: function () { return recipe_1.RenderingVariantDefinitionSchema; } });
+Object.defineProperty(exports, "SectionDefinitionRecipeSchema", { enumerable: true, get: function () { return recipe_1.SectionDefinitionRecipeSchema; } });
+Object.defineProperty(exports, "SiteGroupingSchema", { enumerable: true, get: function () { return recipe_1.SiteGroupingSchema; } });
+Object.defineProperty(exports, "SiteRecipeSchema", { enumerable: true, get: function () { return recipe_1.SiteRecipeSchema; } });
+Object.defineProperty(exports, "SiteTemplateDictionaryEntrySchema", { enumerable: true, get: function () { return recipe_1.SiteTemplateDictionaryEntrySchema; } });
+Object.defineProperty(exports, "SiteTemplateRecipeSchema", { enumerable: true, get: function () { return recipe_1.SiteTemplateRecipeSchema; } });
+Object.defineProperty(exports, "SiteTemplateTaxonomyEntrySchema", { enumerable: true, get: function () { return recipe_1.SiteTemplateTaxonomyEntrySchema; } });
+Object.defineProperty(exports, "SitecoreFieldAugmentSchema", { enumerable: true, get: function () { return recipe_1.SitecoreFieldAugmentSchema; } });
+var field_types_1 = require("./schema/field-types");
+Object.defineProperty(exports, "FIELD_SHAPES", { enumerable: true, get: function () { return field_types_1.FIELD_SHAPES; } });
+Object.defineProperty(exports, "FieldShapeSchema", { enumerable: true, get: function () { return field_types_1.FieldShapeSchema; } });
+Object.defineProperty(exports, "SITECORE_FIELD_TYPES", { enumerable: true, get: function () { return field_types_1.SITECORE_FIELD_TYPES; } });
+Object.defineProperty(exports, "SitecoreFieldTypeSchema", { enumerable: true, get: function () { return field_types_1.SitecoreFieldTypeSchema; } });
+Object.defineProperty(exports, "defaultSitecoreFieldType", { enumerable: true, get: function () { return field_types_1.defaultSitecoreFieldType; } });
+Object.defineProperty(exports, "sitecoreFieldTypeLabel", { enumerable: true, get: function () { return field_types_1.sitecoreFieldTypeLabel; } });
+// Compiler ----------------------------------------------------------------
+var compile_1 = require("./compile");
+Object.defineProperty(exports, "compileComponentTemplateRecipe", { enumerable: true, get: function () { return compile_1.compileComponentTemplateRecipe; } });
+Object.defineProperty(exports, "compileContentItemRecipe", { enumerable: true, get: function () { return compile_1.compileContentItemRecipe; } });
+Object.defineProperty(exports, "compileContentTemplateRecipe", { enumerable: true, get: function () { return compile_1.compileContentTemplateRecipe; } });
+Object.defineProperty(exports, "compilePageDesignRecipe", { enumerable: true, get: function () { return compile_1.compilePageDesignRecipe; } });
+Object.defineProperty(exports, "compileParametersTemplateRecipe", { enumerable: true, get: function () { return compile_1.compileParametersTemplateRecipe; } });
+Object.defineProperty(exports, "compilePartialDesignRecipe", { enumerable: true, get: function () { return compile_1.compilePartialDesignRecipe; } });
+Object.defineProperty(exports, "compileRecipe", { enumerable: true, get: function () { return compile_1.compileRecipe; } });
+Object.defineProperty(exports, "compileRecipeSet", { enumerable: true, get: function () { return compile_1.compileRecipeSet; } });
+Object.defineProperty(exports, "compileSectionDefinitionRecipe", { enumerable: true, get: function () { return compile_1.compileSectionDefinitionRecipe; } });
+Object.defineProperty(exports, "compileSiteRecipe", { enumerable: true, get: function () { return compile_1.compileSiteRecipe; } });
+Object.defineProperty(exports, "compileSiteTemplateRecipe", { enumerable: true, get: function () { return compile_1.compileSiteTemplateRecipe; } });
+Object.defineProperty(exports, "TEMPLATES_MAPPING_AGGREGATE_HANDLE", { enumerable: true, get: function () { return compile_1.TEMPLATES_MAPPING_AGGREGATE_HANDLE; } });
+var emit_1 = require("./layout/emit");
+Object.defineProperty(exports, "emitLayoutXml", { enumerable: true, get: function () { return emit_1.emitLayoutXml; } });
+var templates_mapping_1 = require("./layout/templates-mapping");
+Object.defineProperty(exports, "encodeTemplatesMapping", { enumerable: true, get: function () { return templates_mapping_1.encodeTemplatesMapping; } });
+// GUID derivation ---------------------------------------------------------
+var guids_1 = require("./guids");
+Object.defineProperty(exports, "NAMESPACE_CONTENT_ITEM", { enumerable: true, get: function () { return guids_1.NAMESPACE_CONTENT_ITEM; } });
+Object.defineProperty(exports, "NAMESPACE_PAGE_DESIGN", { enumerable: true, get: function () { return guids_1.NAMESPACE_PAGE_DESIGN; } });
+Object.defineProperty(exports, "NAMESPACE_PARTIAL_DESIGN", { enumerable: true, get: function () { return guids_1.NAMESPACE_PARTIAL_DESIGN; } });
+Object.defineProperty(exports, "NAMESPACE_PROJECT", { enumerable: true, get: function () { return guids_1.NAMESPACE_PROJECT; } });
+Object.defineProperty(exports, "NAMESPACE_RENDERING", { enumerable: true, get: function () { return guids_1.NAMESPACE_RENDERING; } });
+Object.defineProperty(exports, "NAMESPACE_ROOT", { enumerable: true, get: function () { return guids_1.NAMESPACE_ROOT; } });
+Object.defineProperty(exports, "NAMESPACE_SECTION_DEFINITION", { enumerable: true, get: function () { return guids_1.NAMESPACE_SECTION_DEFINITION; } });
+Object.defineProperty(exports, "NAMESPACE_SITE_BRANCH", { enumerable: true, get: function () { return guids_1.NAMESPACE_SITE_BRANCH; } });
+Object.defineProperty(exports, "NAMESPACE_TEMPLATE", { enumerable: true, get: function () { return guids_1.NAMESPACE_TEMPLATE; } });
+Object.defineProperty(exports, "PAGE_DESIGNS_ROOT_REF_KEY", { enumerable: true, get: function () { return guids_1.PAGE_DESIGNS_ROOT_REF_KEY; } });
+Object.defineProperty(exports, "componentFolderStandardValuesId", { enumerable: true, get: function () { return guids_1.componentFolderStandardValuesId; } });
+Object.defineProperty(exports, "componentFolderTemplateId", { enumerable: true, get: function () { return guids_1.componentFolderTemplateId; } });
+Object.defineProperty(exports, "componentFoldersBucketId", { enumerable: true, get: function () { return guids_1.componentFoldersBucketId; } });
+Object.defineProperty(exports, "contentItemId", { enumerable: true, get: function () { return guids_1.contentItemId; } });
+Object.defineProperty(exports, "contentModelsGroupFolderId", { enumerable: true, get: function () { return guids_1.contentModelsGroupFolderId; } });
+Object.defineProperty(exports, "datasourceId", { enumerable: true, get: function () { return guids_1.datasourceId; } });
+Object.defineProperty(exports, "fieldId", { enumerable: true, get: function () { return guids_1.fieldId; } });
+Object.defineProperty(exports, "pageDesignId", { enumerable: true, get: function () { return guids_1.pageDesignId; } });
+Object.defineProperty(exports, "paramsFieldId", { enumerable: true, get: function () { return guids_1.paramsFieldId; } });
+Object.defineProperty(exports, "paramsSectionId", { enumerable: true, get: function () { return guids_1.paramsSectionId; } });
+Object.defineProperty(exports, "paramsTemplateId", { enumerable: true, get: function () { return guids_1.paramsTemplateId; } });
+Object.defineProperty(exports, "partialDesignId", { enumerable: true, get: function () { return guids_1.partialDesignId; } });
+Object.defineProperty(exports, "presentationParametersBucketId", { enumerable: true, get: function () { return guids_1.presentationParametersBucketId; } });
+Object.defineProperty(exports, "renderingId", { enumerable: true, get: function () { return guids_1.renderingId; } });
+Object.defineProperty(exports, "renderingsSectionFolderId", { enumerable: true, get: function () { return guids_1.renderingsSectionFolderId; } });
+Object.defineProperty(exports, "sectionDefinitionId", { enumerable: true, get: function () { return guids_1.sectionDefinitionId; } });
+Object.defineProperty(exports, "sectionFolderId", { enumerable: true, get: function () { return guids_1.sectionFolderId; } });
+Object.defineProperty(exports, "sectionId", { enumerable: true, get: function () { return guids_1.sectionId; } });
+Object.defineProperty(exports, "siteBranchId", { enumerable: true, get: function () { return guids_1.siteBranchId; } });
+Object.defineProperty(exports, "siteDataFolderId", { enumerable: true, get: function () { return guids_1.siteDataFolderId; } });
+Object.defineProperty(exports, "standardValuesId", { enumerable: true, get: function () { return guids_1.standardValuesId; } });
+Object.defineProperty(exports, "templateId", { enumerable: true, get: function () { return guids_1.templateId; } });
+Object.defineProperty(exports, "variantId", { enumerable: true, get: function () { return guids_1.variantId; } });
+Object.defineProperty(exports, "variantsFolderId", { enumerable: true, get: function () { return guids_1.variantsFolderId; } });
+// Operation IR ------------------------------------------------------------
+var operations_1 = require("./ir/operations");
+Object.defineProperty(exports, "AppendToMultiListOpSchema", { enumerable: true, get: function () { return operations_1.AppendToMultiListOpSchema; } });
+Object.defineProperty(exports, "CreateItemOpSchema", { enumerable: true, get: function () { return operations_1.CreateItemOpSchema; } });
+Object.defineProperty(exports, "FieldValueSchema", { enumerable: true, get: function () { return operations_1.FieldValueSchema; } });
+Object.defineProperty(exports, "OperationIrSchema", { enumerable: true, get: function () { return operations_1.OperationIrSchema; } });
+Object.defineProperty(exports, "OperationSchema", { enumerable: true, get: function () { return operations_1.OperationSchema; } });
+Object.defineProperty(exports, "PushPolicySchema", { enumerable: true, get: function () { return operations_1.PushPolicySchema; } });
+Object.defineProperty(exports, "RefValueSchema", { enumerable: true, get: function () { return operations_1.RefValueSchema; } });
+Object.defineProperty(exports, "SetBaseTemplatesOpSchema", { enumerable: true, get: function () { return operations_1.SetBaseTemplatesOpSchema; } });
+Object.defineProperty(exports, "SetFieldOpSchema", { enumerable: true, get: function () { return operations_1.SetFieldOpSchema; } });
+Object.defineProperty(exports, "SetStandardValuesOpSchema", { enumerable: true, get: function () { return operations_1.SetStandardValuesOpSchema; } });
+var sitecore_templates_1 = require("./ir/sitecore-templates");
+Object.defineProperty(exports, "COMPOSITION_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.COMPOSITION_FIELDS; } });
+Object.defineProperty(exports, "DEFAULT_DEVICE_ID", { enumerable: true, get: function () { return sitecore_templates_1.DEFAULT_DEVICE_ID; } });
+Object.defineProperty(exports, "DEFAULT_ICON", { enumerable: true, get: function () { return sitecore_templates_1.DEFAULT_ICON; } });
+Object.defineProperty(exports, "DEFAULT_LANGUAGE", { enumerable: true, get: function () { return sitecore_templates_1.DEFAULT_LANGUAGE; } });
+Object.defineProperty(exports, "DEFAULT_VERSION", { enumerable: true, get: function () { return sitecore_templates_1.DEFAULT_VERSION; } });
+Object.defineProperty(exports, "LAYOUT_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.LAYOUT_FIELDS; } });
+Object.defineProperty(exports, "RENDERING_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.RENDERING_FIELDS; } });
+Object.defineProperty(exports, "SECTION_DEFINITION_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.SECTION_DEFINITION_FIELDS; } });
+Object.defineProperty(exports, "SITE_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.SITE_FIELDS; } });
+Object.defineProperty(exports, "SITE_TEMPLATE_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.SITE_TEMPLATE_FIELDS; } });
+Object.defineProperty(exports, "SITECORE_TEMPLATES", { enumerable: true, get: function () { return sitecore_templates_1.SITECORE_TEMPLATES; } });
+Object.defineProperty(exports, "STANDARD_TEMPLATE_ID", { enumerable: true, get: function () { return sitecore_templates_1.STANDARD_TEMPLATE_ID; } });
+Object.defineProperty(exports, "SYSTEM_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.SYSTEM_FIELDS; } });
+Object.defineProperty(exports, "TEMPLATE_FIELD_FIELDS", { enumerable: true, get: function () { return sitecore_templates_1.TEMPLATE_FIELD_FIELDS; } });
+// Planner / executor ------------------------------------------------------
+var plan_1 = require("./plan");
+Object.defineProperty(exports, "buildPlan", { enumerable: true, get: function () { return plan_1.buildPlan; } });
+var execute_1 = require("./execute");
+Object.defineProperty(exports, "executeIr", { enumerable: true, get: function () { return execute_1.executeIr; } });
+// Reference encoding (RefValue → canonical Sitecore string) -------------
+var ref_encoding_1 = require("./api/ref-encoding");
+Object.defineProperty(exports, "renderRefValue", { enumerable: true, get: function () { return ref_encoding_1.renderRefValue; } });
+// Source fields (recipe `sitecore.sourceTypes/Query/Scope/Raw`) ---------
+var source_fields_1 = require("./schema/source-fields");
+Object.defineProperty(exports, "renderSourceFields", { enumerable: true, get: function () { return source_fields_1.renderSourceFields; } });
+Object.defineProperty(exports, "sourceFieldsNeedHandleResolution", { enumerable: true, get: function () { return source_fields_1.sourceFieldsNeedHandleResolution; } });
+// Policy assignment (Phase 3+ extension point) --------------------------
+var policy_1 = require("./policy");
+Object.defineProperty(exports, "defaultPolicyForRecipe", { enumerable: true, get: function () { return policy_1.defaultPolicyForRecipe; } });
+Object.defineProperty(exports, "policyFor", { enumerable: true, get: function () { return policy_1.policyFor; } });
+Object.defineProperty(exports, "policyForOp", { enumerable: true, get: function () { return policy_1.policyForOp; } });
+Object.defineProperty(exports, "purposeForRecipe", { enumerable: true, get: function () { return policy_1.purposeForRecipe; } });
+// Cross-recipe validation -----------------------------------------------
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "formatValidationErrors", { enumerable: true, get: function () { return validate_1.formatValidationErrors; } });
+Object.defineProperty(exports, "isValid", { enumerable: true, get: function () { return validate_1.isValid; } });
+Object.defineProperty(exports, "validateRecipeSet", { enumerable: true, get: function () { return validate_1.validateRecipeSet; } });
+Object.defineProperty(exports, "validateRecipeSetOrThrow", { enumerable: true, get: function () { return validate_1.validateRecipeSetOrThrow; } });

package/dist/recipe/io.d.ts

@@ -0,0 +1,21 @@
+import { type Recipe } from "./schema/recipe";
+import { type OperationIr } from "./ir/operations";
+import type { Plan } from "./plan";
+/**
+ * Load a recipe file. Supports both shapes:
+ *
+ *   - `.recipe.ts` — TypeScript source compiled at runtime via `tsx/cjs/api`.
+ *     Recipes export the recipe object as either the default export or a
+ *     named export (the first one found wins).
+ *   - `.recipe.json` — pre-serialized recipe JSON.
+ *
+ * Validates against `RecipeSchema` (the `Recipe = ComponentTemplateRecipe |
+ * ContentTemplateRecipe` discriminated union) so both kinds parse uniformly.
+ */
+export declare const loadRecipe: (filePath: string) => Promise<Recipe>;
+export declare const writeIr: (filePath: string, ir: OperationIr) => Promise<void>;
+export declare const loadIr: (filePath: string) => Promise<OperationIr>;
+export declare const writePlan: (filePath: string, plan: Plan) => Promise<void>;
+export declare const defaultIrPath: (recipeHandle: string, baseDir: string) => string;
+export declare const defaultPlanPath: (recipeHandle: string, baseDir: string) => string;
+//# sourceMappingURL=io.d.ts.map

package/dist/recipe/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/recipe/io.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA2CnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAiBjE,CAAC;AA6DF,eAAO,MAAM,OAAO,GAAU,UAAU,MAAM,EAAE,IAAI,WAAW,KAAG,OAAO,CAAC,IAAI,CAE7E,CAAC;AAEF,eAAO,MAAM,MAAM,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,WAAW,CAYlE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,EAAE,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAE1E,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,KAAG,MACC,CAAC;AAExE,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,KAAG,MACC,CAAC"}

package/dist/recipe/io.js

@@ -0,0 +1,147 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultPlanPath = exports.defaultIrPath = exports.writePlan = exports.loadIr = exports.writeIr = exports.loadRecipe = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../shared/errors");
+const recipe_1 = require("./schema/recipe");
+const operations_1 = require("./ir/operations");
+/**
+ * Recipe + IR + Plan I/O.
+ *
+ * Recipes ship as `.recipe.json` (the runtime contract — the registry
+ * build emits these from authored `.recipe.ts` files). IR documents are
+ * `.ir.json`. Plans, when persisted, are `.plan.json`. All three pass
+ * through Zod parsing on read; structural drift surfaces here, not later
+ * in the planner.
+ */
+const readJson = async (filePath) => {
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw (0, errors_1.createCliError)(`File not found: ${filePath}`, "INPUT_INVALID", {
+                hint: "Check the path spelling and that the file exists.",
+            });
+        }
+        throw (0, errors_1.createCliError)(`Failed to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, "INPUT_INVALID");
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw (0, errors_1.createCliError)(`Invalid JSON in ${filePath}: ${error instanceof Error ? error.message : String(error)}`, "INPUT_INVALID", { hint: "Ensure the file contains a valid JSON document." });
+    }
+};
+const writeJson = async (filePath, value) => {
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+    await node_fs_1.promises.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+};
+/**
+ * Load a recipe file. Supports both shapes:
+ *
+ *   - `.recipe.ts` — TypeScript source compiled at runtime via `tsx/cjs/api`.
+ *     Recipes export the recipe object as either the default export or a
+ *     named export (the first one found wins).
+ *   - `.recipe.json` — pre-serialized recipe JSON.
+ *
+ * Validates against `RecipeSchema` (the `Recipe = ComponentTemplateRecipe |
+ * ContentTemplateRecipe` discriminated union) so both kinds parse uniformly.
+ */
+const loadRecipe = async (filePath) => {
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    const raw = ext === ".ts" || ext === ".tsx" || ext === ".mts" || ext === ".cts"
+        ? await loadRecipeFromTypeScript(filePath)
+        : await readJson(filePath);
+    const result = recipe_1.RecipeSchema.safeParse(raw);
+    if (!result.success) {
+        throw (0, errors_1.createCliError)(`Invalid recipe at ${filePath}.`, "INPUT_INVALID", {
+            hint: "Ensure the file exports a `ComponentTemplateRecipe` or `ContentTemplateRecipe`.",
+            details: result.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`),
+        });
+    }
+    return result.data;
+};
+exports.loadRecipe = loadRecipe;
+/**
+ * Lazily install tsx's CommonJS require hook *once* per process. Earlier
+ * versions of this file called `register()` and the matching `unregister`
+ * cleanup on every `loadRecipe` call — fine for one-shot CLI runs but
+ * wasteful in long-running surfaces like `scai shell` where N recipe
+ * loads = N register/unregister cycles. Once installed, the hook stays
+ * for the rest of the process lifetime; recipe changes mid-shell-session
+ * therefore require an exit (the per-recipe `require.cache` clear below
+ * handles re-imports of the *same* file path within the same process).
+ */
+let tsxRegistered = false;
+const ensureTsxRegistered = () => {
+    if (tsxRegistered) {
+        return;
+    }
+    /* eslint-disable @typescript-eslint/no-require-imports */
+    const tsxApi = require("tsx/cjs/api");
+    /* eslint-enable @typescript-eslint/no-require-imports */
+    tsxApi.register();
+    tsxRegistered = true;
+};
+const loadRecipeFromTypeScript = async (filePath) => {
+    const absolute = node_path_1.default.resolve(filePath);
+    try {
+        ensureTsxRegistered();
+        if (require.cache[absolute]) {
+            delete require.cache[absolute];
+        }
+        /* eslint-disable @typescript-eslint/no-require-imports */
+        const mod = require(absolute);
+        /* eslint-enable @typescript-eslint/no-require-imports */
+        if (mod.default !== undefined) {
+            return mod.default;
+        }
+        // Fall back to the first non-default exported value.
+        for (const key of Object.keys(mod)) {
+            if (key !== "default" && mod[key] !== undefined) {
+                return mod[key];
+            }
+        }
+        throw (0, errors_1.createCliError)(`Recipe at ${filePath} has no exports.`, "INPUT_INVALID", {
+            hint: "Add `export default <recipe>` (or any named export) to the file.",
+        });
+    }
+    catch (error) {
+        // Don't double-wrap our own CliErrors (e.g. "Recipe at <path> has no exports.").
+        if (error instanceof errors_1.CliError) {
+            throw error;
+        }
+        throw (0, errors_1.createCliError)(`Failed to load recipe TypeScript file ${filePath}: ${error instanceof Error ? error.message : String(error)}`, "INPUT_INVALID", { hint: "Confirm the file compiles standalone (try `pnpm exec tsx <file>`)." });
+    }
+};
+const writeIr = async (filePath, ir) => {
+    await writeJson(filePath, ir);
+};
+exports.writeIr = writeIr;
+const loadIr = async (filePath) => {
+    const json = await readJson(filePath);
+    const result = operations_1.OperationIrSchema.safeParse(json);
+    if (!result.success) {
+        throw (0, errors_1.createCliError)(`Invalid Operation IR at ${filePath}.`, "INPUT_INVALID", {
+            hint: "Re-run `scai recipe compile` to regenerate the IR.",
+            details: result.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`),
+        });
+    }
+    return result.data;
+};
+exports.loadIr = loadIr;
+const writePlan = async (filePath, plan) => {
+    await writeJson(filePath, plan);
+};
+exports.writePlan = writePlan;
+const defaultIrPath = (recipeHandle, baseDir) => node_path_1.default.join(baseDir, ".scai", `${slugifyHandle(recipeHandle)}.ir.json`);
+exports.defaultIrPath = defaultIrPath;
+const defaultPlanPath = (recipeHandle, baseDir) => node_path_1.default.join(baseDir, ".scai", `${slugifyHandle(recipeHandle)}.plan.json`);
+exports.defaultPlanPath = defaultPlanPath;
+const slugifyHandle = (handle) => handle.replace(/@/g, "_v");