@ama-sdk/schematics 14.1.0-prerelease.9 → 14.1.0-rc.0

package/README.md

@@ -116,10 +116,11 @@ To align ourselves with OpenAPI 3.1, we now support arrays and objects in path a
 Based on the values of the keywords `style` and `explode` within the specification file, the parameters are serialized accordingly in the URLs of the APIs.
 For more information, check out OpenAPI's documentation on [parameter serialization](https://swagger.io/specification/).
 
-It is important to note that, as in OpenAPI 3.1, we only support simple arrays and simple non-nested objects in path and query parameters. 
+It is important to note that, as in OpenAPI 3.1, we only support simple arrays and simple non-nested objects in path and query parameters.
 The parameter types that we support are stored in `SupportedParamType` in the package `@ama-sdk/core`.
 
 To enable the parameter serialization within your API, you can set the option `enableParameterSerialization` to `true` (its current default value is `false`) in the constructor. For example:
+
 ```typescript
 const apiConfig: ApiClient = new ApiFetchClient(
   {
@@ -163,9 +164,10 @@ If your specification file includes dates, there are multiple options for the ge
   For more information related to these types, check out this [documentation](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/schematics/schematics/typescript/shell/templates/base#manage-dates).
   This can be done by adding `--global-property stringifyDate=false` to the generator command or by adding the global property
 to the `openapitools.json`.
+
 > [!NOTE]
 > An extra type to manage special timezone use cases can be used at property level thanks to the
-> `x-local-timezone` vendor. 
+> `x-local-timezone` vendor.
 > Please check out the [date documentation](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/schematics/schematics/typescript/shell/templates/base#manage-dates).
 
 Example to use `Date`:
@@ -174,6 +176,30 @@ Example to use `Date`:
 yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property stringifyDate=false
 ```
 
+##### Request Body Transformation
+
+You may want to customize the request body parameters in your SDK.
+This can be done by using the global property option `requestBodyTransform` by adding `--global-property requestBodyTransform=yourTransform` to the generator command.
+The original name of the body request parameter can be referred in the value of `requestBodyTransform` with `{{bodyRequest}}`.
+
+Examples:
+
+```shell
+yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property requestBodyTransform=content{{bodyRequest}}
+```
+
+> In this example, the prefix for request body parameters will be prefixed with `content`.
+
+```shell
+yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property requestBodyTransform=content
+```
+
+> In this example, the prefix for request body parameters will be replaced by `content`.
+
+The Body request parameter generated in the SDK can also be defined in the specification file by using the vendor extension `x-body-param-name` at body parameter level.
+> [!WARNING]
+> This vendor extension will take precedence over the global property `requestBodyTransform`.
+
 ##### Extensible models
 
 You may be in a case in which you want to be able to extend your SDK models and therefore ensure that revivers are generated
@@ -328,3 +354,4 @@ Use `--help` on each command for more information
 | amasdk-clear-index          | Remove the index files that are no longer necessary after the deletion of the associated model |
 | amasdk-files-pack           | Prepare the dist folder for publication                                                        |
 | amasdk-update-spec-from-npm | Update the OpenAPI spec from an NPM package                                                    |
+| amasdk-update-sdk-context   | Update the SDK_CONTEXT.md file with the latest information from the OpenAPI spec (see [update-sdk-context](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/schematics/cli/genai-context/README.md))               |

package/cli/clear-index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-index.cjs","sourceRoot":"","sources":["../../cli/clear-index.cts"],"names":[],"mappings":";;AAEA;;GAEG;;AAEH,qCAGiB;AACjB,yCAEmB;AAInB,qCAAqC;AAErC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;AAC7B,MAAM,OAAO,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAChE,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAEtB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAEjG,IAAI,IAAI,EAAE,CAAC;IACT,oHAAoH;IACpH,OAAO,CAAC,GAAG,CAAC;;GAEX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7C,MAAM;SACH,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,kBAAQ,EAAC,IAAA,mBAAO,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAChE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,IAAA,mBAAO,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CACL,CAAC;IACF,MAAM,kBAAkB,GAAG,qBAAqB;SAC7C,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC;SACxC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAE7B,MAAM,OAAO,CAAC,GAAG,CACf,kBAAkB;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC;QACvC,OAAO,kBAAE,CAAC,MAAM,CAAC,IAAA,mBAAO,EAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CAAC;AAEF,KAAK,CAAC,KAAK,IAAI,EAAE;IACf,IAAI,OAAO,GAAe,CAAC,EAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,2CAAa,gBAAgB,EAAC,CAAC;QAChE,OAAO,GAAG,oBAAoB,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,iCAAiC,CAAC,EAAE,CAAC;AAC3D,CAAC,CAAC,EAAE,CAAC"}

package/cli/files-pack.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-pack.cjs","sourceRoot":"","sources":["../../cli/files-pack.cts"],"names":[],"mappings":"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"}

package/cli/genai-context/templates/SDK_CONTEXT.md.template

@@ -0,0 +1,64 @@
+# SDK Context for AI Tools
+
+This document provides context about the generated TypeScript SDK to help AI assistants understand the codebase structure and avoid hallucinations.
+
+## SDK Information
+
+- **Package Name**: `<%= packageName %>`
+- **OpenAPI Version**: `<%= openApiVersion %>`
+- **API Title**: <%= apiTitle %>
+- **Generated with**: `@ama-sdk/schematics:typescript-core`
+
+## Project Structure
+
+```
+<%= packageName %>/
+├── api/                    # API endpoint classes (domain-based)
+<%= domainTree %>
+│   └── index.ts
+├── models/
+│   ├── base/               # Auto-generated from OpenAPI (DO NOT MODIFY)
+│   ├── core/               # Extensions of base models if needed
+│   ├── custom/             # Custom business models if needed
+│   └── index.ts
+├── spec/                   # Operation specifications
+├── fixtures/               # Test fixtures
+├── open-api.yaml               # OpenAPI specification source
+└── openapitools.json           # Generator configuration
+```
+
+<!-- DOMAINS-START -->
+## Domains
+
+The following domains were extracted from the OpenAPI specification. Each domain represents a logical grouping of related API operations.
+
+<%= domainsSection %>
+<!-- DOMAINS-END -->
+
+## Important Guidelines
+
+### DO NOT
+
+- Modify files in `models/base/` - these are auto-generated
+- Invent operation IDs that don't exist in the domains above
+- Assume model properties not defined in the OpenAPI spec
+- Create new API classes outside the domain structure
+
+### DO
+
+- Use the exact operation IDs listed above
+- Reference models from `models/base/` (or `src/models/base/` in case mcp server is running in the o3r/framework project) for type definitions
+- Check `api/{domain}/{domain}-api.ts` for available methods
+
+## User Disambiguation Notes
+
+<!-- Add project-specific clarifications below -->
+<% if (disambiguation) { %>
+<%= disambiguation %>
+<% } else { %>
+ (No disambiguation notes added yet. Run with --interactive to add notes.)
+<% } %>
+
+---
+
+*This file was generated using `amasdk-update-sdk-context`. Re-run after SDK regeneration to update domains.*

package/cli/genai-context/update-sdk-context.cjs

@@ -0,0 +1,355 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSdkContext = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_readline_1 = require("node:readline");
+const core_1 = require("@angular-devkit/core");
+const schematics_1 = require("@o3r/schematics");
+const js_yaml_1 = require("js-yaml");
+const update_sdk_context_helpers_1 = require("./update-sdk-context.helpers");
+const update_sdk_context_template_1 = require("./update-sdk-context.template");
+const DOMAIN_DESCRIPTIONS_FILENAME = 'domain-descriptions.json';
+/**
+ * Load OpenAPI specifications from file or default locations
+ * @param projectPath Path to the OpenAPI specification file
+ * @param specFileName Name of the OpenAPI specification file
+ * @returns OpenAPI specification as JSON object
+ */
+function loadOpenAPISpec(projectPath, specFileName) {
+    let isYaml = false;
+    let specPath;
+    if (specFileName) {
+        specPath = (0, node_path_1.resolve)(projectPath, specFileName);
+        if (!(0, node_fs_1.existsSync)(specPath)) {
+            throw new Error(`OpenAPI specification not found at: ${specPath}`);
+        }
+        isYaml = specPath.endsWith('.yaml') || specPath.endsWith('.yml');
+    }
+    else {
+        const yamlPath = (0, node_path_1.join)(projectPath, 'open-api.yaml');
+        const jsonPath = (0, node_path_1.join)(projectPath, 'open-api.json');
+        if ((0, node_fs_1.existsSync)(yamlPath)) {
+            specPath = yamlPath;
+            isYaml = true;
+        }
+        else if ((0, node_fs_1.existsSync)(jsonPath)) {
+            specPath = jsonPath;
+        }
+        else {
+            throw new Error(`No OpenAPI specification found. Looked for:\n  - ${yamlPath}\n  - ${jsonPath}`);
+        }
+    }
+    const specContent = (0, node_fs_1.readFileSync)(specPath, 'utf8');
+    try {
+        return (isYaml ? (0, js_yaml_1.load)(specContent) : JSON.parse(specContent));
+    }
+    catch (error) {
+        throw new Error(`Failed to parse OpenAPI specification at ${specPath}: ${error.message}`);
+    }
+}
+/**
+ * Read the domain descriptions from user file, this allow for custom domain descriptions
+ * and extra clarifications
+ * @param filePath Path to the domain descriptions file
+ */
+function loadDomainDescriptions(filePath) {
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        throw new Error(`Domain descriptions file not found: ${filePath}`);
+    }
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+    }
+    catch {
+        throw new Error(`Failed to parse domain descriptions file: ${filePath}`);
+    }
+}
+/**
+ * Read the package.json file
+ * @param projectPath Path to the project root
+ */
+function loadPackageJson(projectPath) {
+    const packagePath = (0, node_path_1.join)(projectPath, 'package.json');
+    if ((0, node_fs_1.existsSync)(packagePath)) {
+        return JSON.parse((0, node_fs_1.readFileSync)(packagePath, 'utf8'));
+    }
+    return {};
+}
+/**
+ * Load and parse existing SDK_CONTEXT.md to extract preserved sections
+ * @param projectPath Path to the project root
+ * @returns Parsed sections or defaults if file doesn't exist
+ */
+function loadExistingContext(projectPath) {
+    const contextPath = (0, node_path_1.join)(projectPath, 'SDK_CONTEXT.md');
+    if (!(0, node_fs_1.existsSync)(contextPath)) {
+        return (0, update_sdk_context_helpers_1.parseExistingContext)(null);
+    }
+    const content = (0, node_fs_1.readFileSync)(contextPath, 'utf8');
+    return (0, update_sdk_context_helpers_1.parseExistingContext)(content);
+}
+/**
+ * Generate the domains section content
+ * @param domains Map of domains
+ * @returns Formatted domains section markdown
+ */
+function generateDomainsSection(domains) {
+    let domainsSection = '';
+    domains.forEach((domain) => {
+        domainsSection += `
+### ${domain.name}
+
+**What this domain is about**: ${domain.description}
+
+**API Class**: \`src/api/${domain.name}/${domain.name}-api.ts\`
+
+**Available Operations:**
+
+| Operation ID | Method | Description |
+|--------------|--------|-------------|
+`;
+        domain.operations.forEach((op) => {
+            domainsSection += `| \`${op.operationId}\` | ${op.method} | ${op.summary} |\n`;
+        });
+        domainsSection += `\n**Models used in this domain:**\n`;
+        if (domain.models.size > 0) {
+            domain.models.forEach((model) => {
+                domainsSection += `- \`${model}\` - imported from \`src/models/base/${core_1.strings.dasherize(model)}/\`\n`;
+            });
+        }
+        else {
+            domainsSection += `- (none)\n`;
+        }
+        domainsSection += '\n';
+    });
+    return domainsSection;
+}
+/**
+ * Generate the SDK_CONTEXT.md file from template
+ * @param spec OpenAPI specification as JSON object
+ * @param domains Map of domains
+ * @param packageName Package name
+ * @param disambiguation Disambiguation notes
+ */
+async function generateContextFile(spec, domains, packageName, disambiguation) {
+    const openApiVersion = 'openapi' in spec ? spec.openapi : ('swagger' in spec ? spec.swagger : 'unknown');
+    const apiTitle = spec.info?.title || 'Unknown API';
+    const domainsSection = generateDomainsSection(domains);
+    const domainTree = Array.from(domains.values())
+        .map((d) => `│   ├── ${d.name}/              # ${d.description.substring(0, 40)}...`)
+        .join('\n');
+    return await (0, update_sdk_context_template_1.renderSdkContextTemplate)({
+        packageName,
+        openApiVersion,
+        apiTitle,
+        domainTree,
+        domainsSection,
+        disambiguation
+    });
+}
+/**
+ * Prompt the user for disambiguation notes
+ * @param domains Map of domains
+ * @param existingDisambiguation Existing disambiguation notes
+ * @param hasCustomDescriptions Whether the user provided custom descriptions
+ * @param domainDescriptionsFileName Name of the domain descriptions file
+ * @param logger Logger instance
+ * @returns Disambiguation notes
+ */
+async function promptForDisambiguation(domains, existingDisambiguation, hasCustomDescriptions, domainDescriptionsFileName, logger) {
+    const rl = (0, node_readline_1.createInterface)({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const question = (prompt) => {
+        return new Promise((res) => rl.question(prompt, res));
+    };
+    logger.log(`
+=== SDK Context Update - Interactive Mode ===
+Computed domain descriptions:
+`);
+    domains.forEach((domain) => {
+        logger.log(`
+    • ${domain.name}
+        Description: ${domain.description}
+        Operations: ${domain.operations.length}
+        Models: ${domain.models.size}
+`);
+    });
+    if (hasCustomDescriptions) {
+        logger.log(`(Using custom descriptions from --domain-descriptions file)`);
+    }
+    const confirmDomains = await question('\nAre these domain descriptions correct? (y/n): ');
+    if (confirmDomains.toLowerCase() !== 'y') {
+        const overrideFile = domainDescriptionsFileName || DOMAIN_DESCRIPTIONS_FILENAME;
+        logger.log(`
+To modify domain descriptions, edit the override file:
+  File: ${overrideFile}
+  Format: { "domainName": "description", ... }
+`);
+        rl.close();
+        throw new Error(hasCustomDescriptions
+            ? `User rejected domain descriptions. Please edit the ${overrideFile} file and re-run this command.`
+            : `User rejected domain descriptions. Create ${overrideFile} and run: amasdk-update-sdk-context --interactive --domain-descriptions ${overrideFile}`);
+    }
+    logger.log(`
+--- Disambiguation Notes ---
+  Add any clarifications AI tools should know about your SDK.
+  Examples: naming conventions, domain relationships, custom extensions, known limitations.
+`);
+    if (existingDisambiguation) {
+        logger.log(`
+Existing notes:
+      ${existingDisambiguation}
+`);
+        const keepExisting = await question(`
+Keep existing disambiguation notes? (y/n): `);
+        if (keepExisting.toLowerCase() === 'y') {
+            const addMore = await question('Add more notes? (y/n): ');
+            if (addMore.toLowerCase() === 'y') {
+                const additional = await question('Enter additional notes (single line): ');
+                rl.close();
+                return `
+${existingDisambiguation}
+${additional}
+`;
+            }
+            rl.close();
+            return existingDisambiguation;
+        }
+    }
+    const newNotes = await question(`
+Enter disambiguation notes (or press Enter to skip):
+`);
+    rl.close();
+    return newNotes || '';
+}
+/**
+ * Get the cpy-cli version from `@ama-sdk/schematics` package.json
+ */
+function getCpyCliVersion() {
+    const schematicsPackagePath = (0, node_path_1.join)(__dirname, '../../../package.json');
+    try {
+        const schematicsPackageJson = JSON.parse((0, node_fs_1.readFileSync)(schematicsPackagePath, 'utf8'));
+        return schematicsPackageJson.devDependencies?.['cpy-cli'] || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Adds a prepare:context script to package.json that copies SDK_CONTEXT.md to dist/
+ * and updates the build script to include prepare:context if needed.
+ * @param packageJsonPath - Path to the package.json file
+ * @param logger - Logger instance
+ */
+async function addPrepareContextScript(packageJsonPath, logger) {
+    try {
+        if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
+            logger.error(`Package.json not found at: ${packageJsonPath}`);
+            return;
+        }
+        const packageJsonContent = (0, node_fs_1.readFileSync)(packageJsonPath, 'utf8');
+        const packageJson = JSON.parse(packageJsonContent);
+        // Initialize scripts object if it doesn't exist
+        packageJson.scripts ||= {};
+        // Initialize devDependencies object if it doesn't exist
+        packageJson.devDependencies ||= {};
+        // Check if cpy-cli is available as dev dependency, install if missing
+        if (!packageJson.devDependencies['cpy-cli']) {
+            const cpyCliVersion = getCpyCliVersion();
+            if (cpyCliVersion) {
+                logger.log(`Installing cpy-cli@${cpyCliVersion} as dev dependency...`);
+                try {
+                    const targetDir = (0, node_path_1.dirname)(packageJsonPath);
+                    (0, node_child_process_1.execFileSync)((0, schematics_1.getPackageManager)(), [
+                        ...(0, schematics_1.getPackageManager)() === 'npm' ? ['install', '--save-dev'] : ['add', '--dev'],
+                        `cpy-cli@${cpyCliVersion}`
+                    ], { cwd: targetDir, stdio: 'pipe', shell: process.platform === 'win32' });
+                    packageJson.devDependencies['cpy-cli'] = cpyCliVersion;
+                    logger.log(`Successfully installed cpy-cli@${cpyCliVersion}`);
+                }
+                catch (error) {
+                    logger.warn(`Failed to install cpy-cli: ${error instanceof Error ? error.message : String(error)}. Please install it manually.`);
+                }
+            }
+            else {
+                logger.warn(`cpy-cli is required but version could not be determined. Please install it manually with: npm install --save-dev cpy-cli`);
+            }
+        }
+        // Update package.json with prepare:context script
+        const updateResult = (0, update_sdk_context_helpers_1.updatePackageJsonForContextScript)(packageJson);
+        if (updateResult.prepareContextAdded) {
+            logger.log(`Added 'prepare:context' script to package.json`);
+        }
+        else {
+            logger.log(`'prepare:context' script already exists in package.json`);
+        }
+        if (updateResult.buildScriptUpdated) {
+            logger.log(`Updated 'build' script to include 'prepare:context'`);
+        }
+        // Write the updated package.json back to file
+        await node_fs_1.promises.writeFile(packageJsonPath, JSON.stringify(updateResult.packageJson, null, 2), 'utf8');
+        logger.log(`Package.json updated successfully: ${packageJsonPath}`);
+    }
+    catch {
+        // Ignore errors for now
+    }
+}
+/**
+ * Generate the SDK_CONTEXT.md file
+ * @param projectPath Path to the project root
+ * @param specFileName Name of the OpenAPI spec file
+ * @param domainDescriptionsFileName Name of the domain descriptions file
+ * @param isInteractive Whether to run in interactive mode
+ * @param prepareScript Whether to add a prepare:context script to package.json
+ * @param preserveEdits Whether to preserve user edits outside the Domains section on re-run
+ * @param logger Logger instance
+ */
+const generateSdkContext = async (projectPath, specFileName, domainDescriptionsFileName, isInteractive, prepareScript, preserveEdits, logger) => {
+    logger.log(`Loading OpenAPI spec from: ${projectPath}`);
+    const spec = loadOpenAPISpec(projectPath, specFileName);
+    const customDescriptions = domainDescriptionsFileName ? loadDomainDescriptions((0, node_path_1.join)(projectPath, domainDescriptionsFileName)) : null;
+    const domains = (0, update_sdk_context_helpers_1.extractDomains)(spec, customDescriptions);
+    const packageJson = loadPackageJson(projectPath);
+    const packageName = packageJson.name || (0, node_path_1.basename)(projectPath);
+    logger.log(`Found ${domains.size} domains with ${Array.from(domains.values()).reduce((sum, d) => sum + d.operations.length, 0)} operations`);
+    // Load existing context to preserve user edits
+    const existingContext = loadExistingContext(projectPath);
+    let disambiguation = existingContext.disambiguation;
+    if (isInteractive) {
+        disambiguation = await promptForDisambiguation(domains, disambiguation, !!customDescriptions, projectPath, logger);
+    }
+    // Generate the new domains section
+    const domainsSection = generateDomainsSection(domains);
+    // If preserveEdits is enabled and we have existing content with markers, preserve user edits; otherwise generate fresh file
+    const contextContent = (preserveEdits && existingContext.beforeDomains !== null && existingContext.afterDomains !== null)
+        ? existingContext.beforeDomains
+            + '<!-- DOMAINS-START -->\n'
+            + '## Domains\n\n'
+            + 'The following domains were extracted from the OpenAPI specification. Each domain represents a logical grouping of related API operations.\n\n'
+            + domainsSection
+            + '<!-- DOMAINS-END -->'
+            + existingContext.afterDomains
+        : await generateContextFile(spec, domains, packageName, disambiguation);
+    const outputPath = (0, node_path_1.join)(projectPath, 'SDK_CONTEXT.md');
+    await node_fs_1.promises.writeFile(outputPath, contextContent, 'utf8');
+    logger.log(`
+    SDK context written to: ${outputPath}
+    --- Domain Summary ---
+  `);
+    domains.forEach((domain) => {
+        logger.log(`${domain.name}:`);
+        domain.operations.forEach((op) => {
+            logger.log(`  - ${op.operationId}`);
+        });
+    });
+    // Handle prepare script addition if requested
+    if (prepareScript) {
+        const targetPackageJsonPath = (0, node_path_1.join)(projectPath, 'package.json');
+        await addPrepareContextScript(targetPackageJsonPath, logger);
+    }
+};
+exports.generateSdkContext = generateSdkContext;
+//# sourceMappingURL=update-sdk-context.cjs.map

package/cli/genai-context/update-sdk-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-context.cjs","sourceRoot":"","sources":["../../../cli/genai-context/update-sdk-context.cts"],"names":[],"mappings":"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"}

package/cli/genai-context/update-sdk-context.d.cts

@@ -0,0 +1,20 @@
+/** Logger interface */
+export type Logger = {
+    log: (message: string) => void;
+    error: (message: string) => void;
+    warn: (message: string) => void;
+    info: (message: string) => void;
+    debug: (message: string) => void;
+};
+/**
+ * Generate the SDK_CONTEXT.md file
+ * @param projectPath Path to the project root
+ * @param specFileName Name of the OpenAPI spec file
+ * @param domainDescriptionsFileName Name of the domain descriptions file
+ * @param isInteractive Whether to run in interactive mode
+ * @param prepareScript Whether to add a prepare:context script to package.json
+ * @param preserveEdits Whether to preserve user edits outside the Domains section on re-run
+ * @param logger Logger instance
+ */
+export declare const generateSdkContext: (projectPath: string, specFileName: string | undefined, domainDescriptionsFileName: string | undefined, isInteractive: boolean, prepareScript: boolean | undefined, preserveEdits: boolean, logger: Logger) => Promise<void>;
+//# sourceMappingURL=update-sdk-context.d.cts.map

package/cli/genai-context/update-sdk-context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-context.d.cts","sourceRoot":"","sources":["../../../cli/genai-context/update-sdk-context.cts"],"names":[],"mappings":"AAyCA,uBAAuB;AACvB,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAuUF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,EACnB,cAAc,MAAM,GAAG,SAAS,EAChC,4BAA4B,MAAM,GAAG,SAAS,EAC9C,eAAe,OAAO,EACtB,eAAe,OAAO,GAAG,SAAS,EAClC,eAAe,OAAO,EACtB,QAAQ,MAAM,kBAsDf,CAAC"}

package/cli/genai-context/update-sdk-context.helpers.d.ts

@@ -0,0 +1,89 @@
+import type { OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
+import type { PackageJson } from 'type-fest';
+/** Supported OpenAPI document types */
+export type OpenAPISpec = OpenAPIV2.Document | OpenAPIV3.Document | OpenAPIV3_1.Document;
+/**
+ * Represents the parsed sections of an existing SDK_CONTEXT.md file
+ */
+export interface ExistingContextSections {
+    /** Content before the DOMAINS-START marker (null if no existing file or no markers) */
+    beforeDomains: string | null;
+    /** Content after the DOMAINS-END marker (null if no existing file or no markers) */
+    afterDomains: string | null;
+    /** Disambiguation notes extracted from the file */
+    disambiguation: string;
+}
+/**
+ * Parse SDK_CONTEXT.md content to extract preserved sections
+ * @param content The content of the SDK_CONTEXT.md file (null if file doesn't exist)
+ * @returns Parsed sections or defaults if content is null
+ */
+export declare function parseExistingContext(content: string | null): ExistingContextSections;
+/**
+ * Result of updating package.json for prepare:context script
+ */
+export interface PrepareContextScriptResult {
+    /** Updated package.json object */
+    packageJson: PackageJson.PackageJsonStandard;
+    /** Whether the prepare:context script was added */
+    prepareContextAdded: boolean;
+    /** Whether the build script was updated */
+    buildScriptUpdated: boolean;
+}
+/**
+ * Updates a package.json object to add prepare:context script and update build script
+ * @param packageJson The package.json object to update
+ * @returns Result containing updated package.json and flags indicating what was changed
+ */
+export declare function updatePackageJsonForContextScript(packageJson: PackageJson): PrepareContextScriptResult;
+/**
+ * Represents a domain extracted from an OpenAPI specification
+ * A domain groups related API operations together
+ */
+export interface Domain {
+    /** Domain name (typically from OpenAPI tag) */
+    name: string;
+    /** Human-readable description of the domain */
+    description: string;
+    /** List of operations belonging to this domain */
+    operations: {
+        /** Unique operation identifier */
+        operationId: string;
+        /** HTTP method (GET, POST, etc.) */
+        method: string;
+        /** Short description of the operation */
+        summary: string;
+        /** API endpoint path */
+        path: string;
+    }[];
+    /** Set of model names referenced by operations in this domain */
+    models: Set<string>;
+}
+/** Standard HTTP methods supported in OpenAPI specifications */
+export declare const HTTP_METHODS: ["get", "post", "put", "delete", "patch", "options", "head"];
+/**
+ * Extracts the model name from an OpenAPI $ref string
+ * @param ref The $ref string to extract from
+ * @returns The model name or null if not found
+ */
+export declare function extractRefModel(ref?: string): string | null;
+/**
+ * Extracts all referenced model names from an OpenAPI operation
+ * @param operation The OpenAPI operation to extract models from
+ * @returns Array of model names
+ */
+export declare function extractModelsFromOperation(operation: OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject): string[];
+/**
+ * Infers a domain name from an API path
+ * @param apiPath The API path to infer from
+ * @returns The inferred domain name or 'default'
+ */
+export declare function inferDomainFromPath(apiPath: string): string;
+/**
+ * Extracts domains from an OpenAPI specification
+ * @param spec The OpenAPI specification to extract from
+ * @param customDescriptions Optional custom descriptions for domains
+ * @returns Map of domain names to Domain objects
+ */
+export declare function extractDomains(spec: OpenAPISpec, customDescriptions?: Record<string, string> | null): Map<string, Domain>;
+//# sourceMappingURL=update-sdk-context.helpers.d.ts.map

package/cli/genai-context/update-sdk-context.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-context.helpers.d.ts","sourceRoot":"","sources":["../../../cli/genai-context/update-sdk-context.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACZ,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,WAAW,EACZ,MAAM,WAAW,CAAC;AAEnB,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB,CAoCpF;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,kCAAkC;IAClC,WAAW,EAAE,WAAW,CAAC,mBAAmB,CAAC;IAC7C,mDAAmD;IACnD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,WAAW,GACvB,0BAA0B,CAwB5B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,UAAU,EAAE;QACV,kCAAkC;QAClC,WAAW,EAAE,MAAM,CAAC;QACpB,oCAAoC;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,yCAAyC;QACzC,OAAO,EAAE,MAAM,CAAC;QAChB,wBAAwB;QACxB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,iEAAiE;IACjE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,gEAAgE;AAChE,eAAO,MAAM,YAAY,8DAA+G,CAAC;AAEzI;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,GAAG,MAAM,EAAE,CA0CvH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwDzH"}