@ama-sdk/schematics 14.1.0-prerelease.40 → 14.1.0-prerelease.41

package/README.md

@@ -116,7 +116,7 @@ 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:
@@ -165,7 +165,7 @@ If your specification file includes dates, there are multiple options for the ge
 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`:
@@ -328,3 +328,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/genai-context/templates/SDK_CONTEXT.md.template

@@ -0,0 +1,63 @@
+# 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
+
+The following domains were extracted from the OpenAPI specification. Each domain represents a logical grouping of related API operations.
+
+<%= domainsSection %>
+
+## Important Guidelines
+
+### DO NOT
+
+- Modify files in `src/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 `src/models/base/` for type definitions
+- Extend functionality in `src/models/core/` or `src/models/custom/` if needed
+- Check `src/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,334 @@
+"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 {};
+}
+/**
+ * Read the existing disambiguation notes from SDK_CONTEXT.md
+ * @param projectPath Path to the project root
+ */
+function loadExistingDisambiguation(projectPath) {
+    const contextPath = (0, node_path_1.join)(projectPath, 'SDK_CONTEXT.md');
+    if ((0, node_fs_1.existsSync)(contextPath)) {
+        const content = (0, node_fs_1.readFileSync)(contextPath, 'utf8');
+        const match = content.match(/## User Disambiguation Notes\s*\n<!-- Add project-specific clarifications below -->\n([\s\S]*?)(?=\n---|\n##|$)/);
+        return match ? match[1].trim() : '';
+    }
+    return '';
+}
+/**
+ * Generate the SDK_CONTEXT.md file
+ * @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';
+    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';
+    });
+    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`);
+            }
+        }
+        // Add the prepare:context script if it doesn't exist
+        if (packageJson.scripts['prepare:context']) {
+            logger.log(`'prepare:context' script already exists in package.json`);
+        }
+        else {
+            packageJson.scripts['prepare:context'] = 'cpy SDK_CONTEXT.md dist/';
+            logger.log(`Added 'prepare:context' script to package.json`);
+        }
+        // Update build script to include prepare:context if it exists and doesn't already include it
+        if (packageJson.scripts.build && !packageJson.scripts.build.includes('prepare:context')) {
+            packageJson.scripts.build = `${packageJson.scripts.build} && npm run prepare:context`;
+            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(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 logger Logger instance
+ */
+const generateSdkContext = async (projectPath, specFileName, domainDescriptionsFileName, isInteractive, prepareScript, 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`);
+    let disambiguation = loadExistingDisambiguation(projectPath);
+    if (isInteractive) {
+        disambiguation = await promptForDisambiguation(domains, disambiguation, !!customDescriptions, projectPath, logger);
+    }
+    const contextContent = 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,19 @@
+/** 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 logger Logger instance
+ */
+export declare const generateSdkContext: (projectPath: string, specFileName: string | undefined, domainDescriptionsFileName: string | undefined, isInteractive: boolean, prepareScript: boolean | undefined, 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":"AAsCA,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;AA4TF;;;;;;;;GAQG;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,QAAQ,MAAM,kBAsCf,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
+/** Supported OpenAPI document types */
+export type OpenAPISpec = OpenAPIV2.Document | OpenAPIV3.Document | OpenAPIV3_1.Document;
+/**
+ * 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;AAEvB,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AAEzF;;;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"}

package/cli/genai-context/update-sdk-context.helpers.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP_METHODS = void 0;
+exports.extractRefModel = extractRefModel;
+exports.extractModelsFromOperation = extractModelsFromOperation;
+exports.inferDomainFromPath = inferDomainFromPath;
+exports.extractDomains = extractDomains;
+/** Standard HTTP methods supported in OpenAPI specifications */
+exports.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
+ */
+function extractRefModel(ref) {
+    if (!ref) {
+        return null;
+    }
+    const match = ref.match(/#\/components\/schemas\/(\w+)/);
+    return match ? match[1] : null;
+}
+/**
+ * Extracts all referenced model names from an OpenAPI operation
+ * @param operation The OpenAPI operation to extract models from
+ * @returns Array of model names
+ */
+function extractModelsFromOperation(operation) {
+    const models = [];
+    const requestBody = operation.requestBody;
+    if (requestBody?.content) {
+        Object.values(requestBody.content).forEach((mediaType) => {
+            const { schema } = mediaType;
+            if (schema && '$ref' in schema) {
+                const model = extractRefModel(schema.$ref);
+                if (model) {
+                    models.push(model);
+                }
+            }
+        });
+    }
+    if (operation.responses) {
+        Object.values(operation.responses).forEach((responseOrRef) => {
+            const response = responseOrRef;
+            if (response.content) {
+                Object.values(response.content).forEach((mediaType) => {
+                    const schema = mediaType.schema;
+                    if (schema && '$ref' in schema) {
+                        const model = extractRefModel(schema.$ref);
+                        if (model) {
+                            models.push(model);
+                        }
+                    }
+                    else if (schema && 'items' in schema) {
+                        const items = schema.items;
+                        if (items && '$ref' in items) {
+                            const itemModel = extractRefModel(items.$ref);
+                            if (itemModel) {
+                                models.push(itemModel);
+                            }
+                        }
+                    }
+                });
+            }
+        });
+    }
+    return models;
+}
+/**
+ * Infers a domain name from an API path
+ * @param apiPath The API path to infer from
+ * @returns The inferred domain name or 'default'
+ */
+function inferDomainFromPath(apiPath) {
+    const segment = apiPath.split('/').find((s) => s && !s.startsWith('{'));
+    return segment || 'default';
+}
+/**
+ * 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
+ */
+function extractDomains(spec, customDescriptions) {
+    const domains = new Map();
+    const isV3 = 'openapi' in spec;
+    if (spec.tags) {
+        spec.tags.forEach((tag) => {
+            const description = customDescriptions?.[tag.name] ?? tag.description ?? `Operations related to ${tag.name}`;
+            domains.set(tag.name, {
+                name: tag.name,
+                description,
+                operations: [],
+                models: new Set()
+            });
+        });
+    }
+    if (spec.paths) {
+        Object.entries(spec.paths).forEach(([apiPath, pathItemOrRef]) => {
+            if (!pathItemOrRef) {
+                return;
+            }
+            const pathObj = pathItemOrRef;
+            exports.HTTP_METHODS.forEach((method) => {
+                const operation = pathObj[method];
+                if (!operation) {
+                    return;
+                }
+                const domainName = operation.tags && operation.tags.length > 0 ? operation.tags[0] : inferDomainFromPath(apiPath);
+                if (!domains.has(domainName)) {
+                    domains.set(domainName, {
+                        name: domainName,
+                        description: customDescriptions?.[domainName] ?? `Operations for ${domainName} (inferred from path)`,
+                        operations: [],
+                        models: new Set()
+                    });
+                }
+                const domain = domains.get(domainName);
+                domain.operations.push({
+                    operationId: operation.operationId || `${method}_${apiPath.replace(/[{}/]/g, '_')}`,
+                    method: method.toUpperCase(),
+                    summary: operation.summary || operation.description || 'No description',
+                    path: apiPath
+                });
+                if (isV3) {
+                    extractModelsFromOperation(operation).forEach((model) => domain.models.add(model));
+                }
+            });
+        });
+    }
+    return domains;
+}
+//# sourceMappingURL=update-sdk-context.helpers.js.map

package/cli/genai-context/update-sdk-context.helpers.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Data required to render the SDK_CONTEXT.md template
+ */
+export interface SdkContextTemplateData {
+    /** The npm package name of the SDK */
+    packageName: string;
+    /** The OpenAPI specification version (e.g., '3.0.2') */
+    openApiVersion: string;
+    /** The API title from the OpenAPI spec */
+    apiTitle: string;
+    /** ASCII tree representation of domain folders */
+    domainTree: string;
+    /** Markdown content describing each domain and its operations */
+    domainsSection: string;
+    /** User-provided disambiguation notes, or null for default message */
+    disambiguation: string | null;
+}
+/**
+ * Generates the SDK_CONTEXT.md content from template data
+ * @param data The template data to populate
+ * @returns The generated markdown content
+ */
+export declare function renderSdkContextTemplate(data: SdkContextTemplateData): Promise<string>;
+//# sourceMappingURL=update-sdk-context.template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-context.template.d.ts","sourceRoot":"","sources":["../../../cli/genai-context/update-sdk-context.template.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF"}

package/cli/genai-context/update-sdk-context.template.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSdkContextTemplate = renderSdkContextTemplate;
+const node_path_1 = require("node:path");
+const ejs_1 = require("ejs");
+const templatePath = (0, node_path_1.join)(__dirname, 'templates', 'SDK_CONTEXT.md.template');
+/**
+ * Generates the SDK_CONTEXT.md content from template data
+ * @param data The template data to populate
+ * @returns The generated markdown content
+ */
+function renderSdkContextTemplate(data) {
+    return (0, ejs_1.renderFile)(templatePath, data);
+}
+//# sourceMappingURL=update-sdk-context.template.js.map

package/cli/genai-context/update-sdk-context.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-context.template.js","sourceRoot":"","sources":["../../../cli/genai-context/update-sdk-context.template.ts"],"names":[],"mappings":";;AAgCA,4DAEC;AAlCD,yCAEmB;AACnB,6BAEa;AAEb,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC;AAoB7E;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,IAA4B;IACnE,OAAO,IAAA,gBAAU,EAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+/*
+ * Extract domains from OpenAPI specification and generate SDK_CONTEXT.md
+ * for AI tools to understand the SDK structure and avoid hallucinations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = require("node:path");
+const minimist = require("minimist");
+const update_sdk_context_cjs_1 = require("./genai-context/update-sdk-context.cjs");
+const argv = minimist(process.argv.slice(2));
+const help = !!argv.help;
+const quiet = !!argv.quiet;
+const isInteractive = !!argv.interactive || !!argv.i;
+const domainDescriptionsFile = argv['domain-descriptions'];
+const specPathArg = argv['spec-path'];
+const prepareScript = argv['prepare-script'];
+const sdkPath = argv['sdk-path'];
+const projectPath = sdkPath ? (0, node_path_1.resolve)(process.cwd(), sdkPath) : (0, node_path_1.resolve)(process.cwd());
+const noop = () => { };
+// eslint-disable-next-line no-console -- only logger available
+const logger = quiet ? { error: console.error, warn: noop, log: noop, info: noop, debug: noop } : console;
+const run = async () => {
+    await (0, update_sdk_context_cjs_1.generateSdkContext)(projectPath, specPathArg, domainDescriptionsFile, isInteractive, prepareScript, logger);
+};
+if (help) {
+    // eslint-disable-next-line no-console -- Help output should always be visible even with --quiet flag
+    console.log(`Extract domains from OpenAPI specification and generate SDK_CONTEXT.md for AI tools.
+  Usage: amasdk-update-sdk-context [options]
+
+  Options:
+    --interactive, -i       Run in interactive mode to validate domains and add disambiguation notes
+    --domain-descriptions   Path to JSON file with custom domain descriptions
+                            Format: { "domainName": "description", ... }
+                            Missing domains will fallback to OpenAPI tag descriptions
+    --spec-path             Path to OpenAPI specification file (default: open-api.yaml or open-api.json in project root)
+    --prepare-script        Add a prepare:context script to package.json that copies SDK_CONTEXT.md to dist folder
+    --sdk-path              Path to SDK directory where SDK_CONTEXT.md will be created and package.json will be modified
+                            (default: current directory)
+    --quiet                 Suppress non-essential output
+    --help                  Show this help message
+  `);
+    process.exit(0);
+}
+void (async () => {
+    let wrapper = (fn) => fn;
+    try {
+        const { createCliWithMetrics } = await Promise.resolve().then(() => require('@o3r/telemetry'));
+        wrapper = createCliWithMetrics;
+    }
+    catch {
+        // Do not throw if `@o3r/telemetry` is not installed
+    }
+    await wrapper(run, '@ama-sdk/schematics:update-sdk-context')();
+})();
+//# sourceMappingURL=update-sdk-genai-context.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-genai-context.cjs","sourceRoot":"","sources":["../../cli/update-sdk-genai-context.cts"],"names":[],"mappings":";;AAEA;;;GAGG;;AAEH,yCAEmB;AAInB,qCAAqC;AACrC,mFAEgD;AAEhD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AACzB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;AAC3B,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,MAAM,sBAAsB,GAAG,IAAI,CAAC,qBAAqB,CAAuB,CAAC;AACjF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAuB,CAAC;AAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAwB,CAAC;AACpE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAuB,CAAC;AACvD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACvF,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AACtB,+DAA+D;AAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAE1G,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,MAAM,IAAA,2CAAkB,EAAC,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AACnH,CAAC,CAAC;AACF,IAAI,IAAI,EAAE,CAAC;IACT,qGAAqG;IACrG,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;GAcX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,CAAC,KAAK,IAAI,EAAE;IACf,IAAI,OAAO,GAAe,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACrC,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,MAAM,OAAO,CAAC,GAAG,EAAE,wCAAwC,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC,EAAE,CAAC"}

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=update-sdk-genai-context.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-sdk-genai-context.d.cts","sourceRoot":"","sources":["../../cli/update-sdk-genai-context.cts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ama-sdk/schematics",
-  "version": "14.1.0-prerelease.40",
+  "version": "14.1.0-prerelease.41",
   "publishConfig": {
     "access": "public"
   },
@@ -11,6 +11,7 @@
     "nx": "nx",
     "ng": "yarn nx",
     "prepare:build:builders": "yarn cpy 'schematics/**/*.json' 'schematics/**/templates/**' 'schematics/**/*.jar' dist/schematics && yarn cpy '{package,collection,migration}.json' dist",
+    "copy:templates": "yarn cpy 'cli/**/*.template' dist/cli",
     "build": "yarn nx build ama-sdk-schematics",
     "postbuild": "patch-package-json-main",
     "build:builders": "tsc -b tsconfig.builders.json --pretty && yarn generate-cjs-manifest",
@@ -21,6 +22,7 @@
   "bin": {
     "amasdk-clear-index": "./cli/clear-index.cjs",
     "amasdk-files-pack": "./cli/files-pack.cjs",
+    "amasdk-update-sdk-context": "./cli/update-sdk-genai-context.cjs",
     "amasdk-update-spec-from-npm": "./cli/update-spec-from-npm.cjs"
   },
   "ng-update": {
@@ -61,12 +63,12 @@
     }
   },
   "peerDependencies": {
-    "@ama-sdk/core": "~14.1.0-prerelease.40",
+    "@ama-sdk/core": "~14.1.0-prerelease.41",
     "@angular-devkit/core": "^21.0.0",
     "@angular-devkit/schematics-cli": "^21.0.0",
     "@angular/cli": "^21.0.0",
-    "@o3r/schematics": "~14.1.0-prerelease.40",
-    "@o3r/telemetry": "~14.1.0-prerelease.40",
+    "@o3r/schematics": "~14.1.0-prerelease.41",
+    "@o3r/telemetry": "~14.1.0-prerelease.41",
     "@openapitools/openapi-generator-cli": "^2.15.0",
     "openapi-types": "^12.0.0",
     "type-fest": "^5.3.1",
@@ -75,8 +77,9 @@
   "dependencies": {
     "@angular-devkit/core": "~21.1.0",
     "@angular-devkit/schematics": "~21.1.0",
-    "@o3r/schematics": "~14.1.0-prerelease.40",
+    "@o3r/schematics": "~14.1.0-prerelease.41",
     "chokidar": "~5.0.0",
+    "ejs": "~3.1.9",
     "globby": "^11.1.0",
     "js-yaml": "^4.1.1",
     "minimatch": "~10.2.0",
@@ -86,19 +89,20 @@
     "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@ama-sdk/core": "~14.1.0-prerelease.40",
+    "@ama-sdk/core": "~14.1.0-prerelease.41",
     "@angular-devkit/schematics-cli": "~21.1.0",
     "@angular/cli": "~21.1.0",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
     "@nx/eslint-plugin": "~22.5.0",
     "@nx/jest": "~22.5.0",
-    "@o3r/build-helpers": "~14.1.0-prerelease.40",
-    "@o3r/eslint-plugin": "~14.1.0-prerelease.40",
-    "@o3r/telemetry": "~14.1.0-prerelease.40",
-    "@o3r/test-helpers": "~14.1.0-prerelease.40",
+    "@o3r/build-helpers": "~14.1.0-prerelease.41",
+    "@o3r/eslint-plugin": "~14.1.0-prerelease.41",
+    "@o3r/telemetry": "~14.1.0-prerelease.41",
+    "@o3r/test-helpers": "~14.1.0-prerelease.41",
     "@openapitools/openapi-generator-cli": "~2.30.0",
     "@schematics/angular": "~21.1.0",
     "@stylistic/eslint-plugin": "~5.7.0",
+    "@types/ejs": "^3.1.2",
     "@types/jest": "~30.0.0",
     "@types/js-yaml": "^4.0.5",
     "@types/minimist": "^1.2.2",