arc-1 1.5.2 → 1.7.0

package/dist/handlers/where-used.d.ts

@@ -1,5 +1,7 @@
 import { type AdtClient } from '../adt/client.js';
 import { type ReferenceResult, type WhereUsedResult } from '../adt/codeintel.js';
+import { type UsageOptions } from '../adt/where-used-native.js';
+import { expandUsageDetails } from './where-used-details.js';
 export type LiveUsageResult = WhereUsedResult | ReferenceResult;
 export interface LiveUsageLookup {
     /** At most `maxResults` entries. */
@@ -12,6 +14,8 @@ export interface LiveUsageLookup {
     warning?: string;
     /** The symbol SAP searched for, from its result scope (absent on the fallback endpoint). */
     searchedFor?: string;
+    scopeFiltering?: 'server' | 'client';
+    usageDetails?: Awaited<ReturnType<typeof expandUsageDetails>>;
 }
 /** Resolve the canonical ADT object URI used by the where-used APIs. */
 export declare function resolveWhereUsedUri(client: AdtClient, objectType: string, objectName: string): Promise<string | null>;
@@ -19,11 +23,12 @@ export declare function resolveWhereUsedUri(client: AdtClient, objectType: strin
  * Run the live SAP-authorized where-used lookup shared by SAPNavigate.references and
  * SAPContext.usages. Older systems fall back to the simple references endpoint.
  *
- * Filtering and paging are both client-side: SAP's `usageReferences` endpoint declares only
+ * Legacy filtering and paging are client-side: the older `usageReferences` endpoint declares only
  * `{?uri}` and ignores every limit/filter we can send — `objectTypeFilter` in the body, and
  * `maxResults`/`maxItemCount`/`searchFromIndex` as query params all return byte-identical
  * responses (verified live on 758, 9 variants). So the full set always crosses the wire; we bound
- * what reaches the model, not what SAP computes.
+ * what reaches the model, not what SAP computes. SAPNavigate optionally uses native scope
+ * on systems advertising it; paging remains client-side.
  */
-export declare function lookupLiveUsages(client: AdtClient, uri: string, objectType?: string, maxResults?: number): Promise<LiveUsageLookup>;
+export declare function lookupLiveUsages(client: AdtClient, uri: string, objectType?: string, maxResults?: number, options?: UsageOptions): Promise<LiveUsageLookup>;
 //# sourceMappingURL=where-used.d.ts.map

package/dist/handlers/where-used.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"where-used.d.ts","sourceRoot":"","sources":["../../src/handlers/where-used.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAO7B,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;AAMhE,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,wEAAwE;AACxE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}
+{"version":3,"file":"where-used.d.ts","sourceRoot":"","sources":["../../src/handlers/where-used.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;AAMhE,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;CAC/D;AAED,wEAAwE;AACxE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,eAAe,CAAC,CAyF1B"}

package/dist/handlers/where-used.js

@@ -4,17 +4,12 @@ import { DataSourcePolicyError } from '../adt/data-source-policy.js';
 import { AdtApiError } from '../adt/errors.js';
 import { internalOperationWarning } from '../adt/internal-data-operations.js';
 import { isOperationAllowed, OperationType } from '../adt/safety.js';
+import { loadNativeUsages, matchesUsageType } from '../adt/where-used-native.js';
 import { normalizeObjectType, objectUrlForType } from './object-types.js';
+import { expandUsageDetails } from './where-used-details.js';
 /** Default page size for where-used. A bare lookup on a common type returns thousands of rows
  *  (CL_ABAP_TYPEDESCR: 6,644 refs ≈ 968k tokens) — far past any context window. */
 const DEFAULT_USAGE_RESULTS = 100;
-/** Match a result's ADT type against a filter: "CLAS" matches "CLAS/OC", "CLAS/OC" matches exactly.
- *  Trimmed — a padded `" CLAS "` would otherwise match nothing and read as "no references found". */
-function matchesObjectType(resultType, filter) {
-    const type = resultType.trim().toUpperCase();
-    const wanted = filter.trim().toUpperCase();
-    return type === wanted || type.startsWith(`${wanted}/`);
-}
 /** Resolve the canonical ADT object URI used by the where-used APIs. */
 export async function resolveWhereUsedUri(client, objectType, objectName) {
     const type = normalizeObjectType(objectType);
@@ -34,13 +29,14 @@ export async function resolveWhereUsedUri(client, objectType, objectName) {
  * Run the live SAP-authorized where-used lookup shared by SAPNavigate.references and
  * SAPContext.usages. Older systems fall back to the simple references endpoint.
  *
- * Filtering and paging are both client-side: SAP's `usageReferences` endpoint declares only
+ * Legacy filtering and paging are client-side: the older `usageReferences` endpoint declares only
  * `{?uri}` and ignores every limit/filter we can send — `objectTypeFilter` in the body, and
  * `maxResults`/`maxItemCount`/`searchFromIndex` as query params all return byte-identical
  * responses (verified live on 758, 9 variants). So the full set always crosses the wire; we bound
- * what reaches the model, not what SAP computes.
+ * what reaches the model, not what SAP computes. SAPNavigate optionally uses native scope
+ * on systems advertising it; paging remains client-side.
  */
-export async function lookupLiveUsages(client, uri, objectType, maxResults) {
+export async function lookupLiveUsages(client, uri, objectType, maxResults, options) {
     // Normalize the filter ONCE, at the entry, and use only this value below. A whitespace-only filter
     // means "no filter" (matching the empty type would match nothing and read as "No references
     // found"). Trimming here rather than at the comparison is what keeps `" CLAS/OC "` behaving like
@@ -52,29 +48,53 @@ export async function lookupLiveUsages(client, uri, objectType, maxResults) {
     let searchedFor;
     let referencedObjectIdentifier;
     let fallbackUsed = false;
+    let native;
     try {
-        ({ results, searchedFor, referencedObjectIdentifier } = await findWhereUsedWithScope(client.http, client.safety, uri, filter));
+        native =
+            options && (options.packages?.length || (options.detail && options.detail !== 'objects'))
+                ? await loadNativeUsages(client, uri, options)
+                : undefined;
+        ({ results, searchedFor, referencedObjectIdentifier } =
+            native ?? (await findWhereUsedWithScope(client.http, client.safety, uri, filter)));
     }
     catch (err) {
-        if (!(err instanceof AdtApiError) || ![404, 405, 415, 501].includes(err.statusCode))
+        if (!(err instanceof AdtApiError) ||
+            ![404, 405, 415, 501].includes(err.statusCode) ||
+            !/\/usageReferences(?:\?|$)/.test(err.path))
             throw err;
+        if (options?.packages?.length)
+            throw new Error('This legacy reference endpoint cannot provide package-filtered results. Retry without packages.');
         results = await findReferences(client.http, client.safety, uri);
         fallbackUsed = true;
     }
     // Kept outside the try: an augment failure must not be mistaken for a missing where-used endpoint.
     let warning;
-    // Empty is SAP's explicit fallback to the original object; absent/nonempty cannot justify enrichment.
-    if (!fallbackUsed && (!scoped || referencedObjectIdentifier === '')) {
-        warning = await augmentInterfaceImplementers(client, uri, filter, results);
+    // Empty also occurs when SAP reports an unsupported search. Require native rows before
+    // treating an empty cursor identifier as fallback to the original object.
+    if (!fallbackUsed && (!scoped || (referencedObjectIdentifier === '' && results.length > 0))) {
+        warning = await augmentInterfaceImplementers(client, uri, filter, results, Boolean(options?.packages?.length));
     }
     if (scoped && !searchedFor) {
         const scopeWarning = 'SAP did not report the searched symbol. Results may refer to the whole object; confirm the scope before using them.';
         warning = warning ? `${warning} ${scopeWarning}` : scopeWarning;
     }
-    const filtered = filter ? results.filter((result) => matchesObjectType(result.type, filter)) : results;
+    const filtered = results.filter((result) => (!filter || matchesUsageType(result.type, filter)) &&
+        (!options?.packages?.length ||
+            (result.type !== 'DEVC/K' &&
+                'packageName' in result &&
+                options.packages.includes(result.packageName.toUpperCase()))));
     const limit = clampSearchResults(maxResults, DEFAULT_USAGE_RESULTS);
+    const usageDetails = options?.detail && options.detail !== 'objects'
+        ? await expandUsageDetails(client, results, filter, options, limit, native?.supportsSnippets ?? false, native?.deadline ?? Date.now())
+        : undefined;
     return {
-        results: filtered.slice(0, limit),
+        results: filtered.slice(0, limit).map(({ ...row }) => {
+            if ('objectIdentifier' in row)
+                delete row.objectIdentifier;
+            return row;
+        }),
+        ...(native && options?.packages?.length ? { scopeFiltering: native.scopeFiltering } : {}),
+        ...(usageDetails ? { usageDetails } : {}),
         total: filtered.length,
         truncated: filtered.length > limit,
         fallbackUsed,
@@ -82,13 +102,15 @@ export async function lookupLiveUsages(client, uri, objectType, maxResults) {
         ...(searchedFor ? { searchedFor } : {}),
     };
 }
-async function augmentInterfaceImplementers(client, uri, objectType, results) {
+async function augmentInterfaceImplementers(client, uri, objectType, results, packageFiltered) {
     const intfMatch = uri.match(/\/sap\/bc\/adt\/oo\/interfaces\/([^/?#]+)/i);
     if (!intfMatch || (objectType && !/^CLAS/i.test(objectType)))
         return undefined;
     const interfaceName = decodeURIComponent(intfMatch[1]).toUpperCase();
     const canFreeSQL = isOperationAllowed(client.safety, OperationType.FreeSQL);
     const canQuery = isOperationAllowed(client.safety, OperationType.Query);
+    if (packageFiltered && (canFreeSQL || canQuery))
+        return 'Interface-implementer enrichment was skipped: SEOMETAREL does not provide packages for filtering. Native results are retained.';
     try {
         let implementers = [];
         if (canFreeSQL) {

package/dist/handlers/where-used.js.map

@@ -1 +1 @@
-{"version":3,"file":"where-used.js","sourceRoot":"","sources":["../../src/handlers/where-used.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"where-used.js","sourceRoot":"","sources":["../../src/handlers/where-used.ts"],"names":[],"mappings":"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"}

package/dist/handlers/write/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/handlers/write/create.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4CH,OAAO,EAAe,KAAK,UAAU,EAAc,MAAM,cAAc,CAAC;AA0BxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAmYpD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA4VjF;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgWtF"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/handlers/write/create.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,OAAO,EAAe,KAAK,UAAU,EAAc,MAAM,cAAc,CAAC;AA4BxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAmapD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAmXjF;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAwXtF"}

package/dist/handlers/write/create.js

@@ -4,8 +4,9 @@
 import { createObject, lockObject, safeUpdateObject, safeUpdateSource, unlockObject, updateObject, } from '../../adt/crud.js';
 import { formatKtdWriteReport, normalizeAdtLanguage, rewriteKtdDocument, } from '../../adt/ddic-xml.js';
 import { activate, activateBatch } from '../../adt/devtools.js';
+import { badiContainerXml, hasBadiImplementations } from '../../adt/enhancement-impl.js';
 import { AdtApiError, AdtSafetyError } from '../../adt/errors.js';
-import { spliceFmSignature } from '../../adt/fm-signature.js';
+import { findFmHeader, spliceFmSignature } from '../../adt/fm-signature.js';
 import { checkOperation, checkPackage, OperationType } from '../../adt/safety.js';
 import { isServerDrivenObjectType } from '../../adt/server-driven.js';
 import { getTransport } from '../../adt/transport.js';
@@ -13,10 +14,11 @@ import { escapeXmlAttr, parseFunctionModuleProperties } from '../../adt/xml-pars
 import { validateAffHeader } from '../../aff/validator.js';
 import { activationDetailMatchesObject } from '../activation-results.js';
 import { guardCdsSyntax } from '../cds-hints.js';
-import { getCachedFeatures, isDomainsEndpointAvailable, isLockObjectsEndpointAvailable, isTablesEndpointAvailable, isTableTypesEndpointAvailable, } from '../feature-cache.js';
+import { getCachedFeatures, isDomainsEndpointAvailable, isEnhoXhbEndpointAvailable, isLockObjectsEndpointAvailable, isTablesEndpointAvailable, isTableTypesEndpointAvailable, } from '../feature-cache.js';
+import { resolveFmDescriptionLanguage } from '../function-parameter-language.js';
 import { canonicalTablType, functionGroupObjectUrl, functionModuleObjectUrl, normalizeWriteObjectType, objectBasePath, objectUrlForType, sourceUrlForType, } from '../object-types.js';
 import { errorResult, textResult } from '../shared.js';
-import { buildCreateXml, createContentTypeForType, DOMA_WRITE_UNAVAILABLE_HINT, ENQU_WRITE_UNAVAILABLE_HINT, getMetadataWriteProperties, isMetadataWriteType, mergePreWriteWarnings, resolveWriteSystemType, runPreWriteLint, runRapPreflightValidation, SKTD_V2_CONTENT_TYPE, stripFmParamCommentBlock, TABL_DT_WRITE_UNAVAILABLE_HINT, TTYP_WRITE_UNAVAILABLE_HINT, tryPostSaveSyntaxCheck, vendorContentTypeForType, } from '../write-helpers.js';
+import { buildCreateXml, createContentTypeForType, DOMA_WRITE_UNAVAILABLE_HINT, ENHO_WRITE_UNAVAILABLE_HINT, ENQU_WRITE_UNAVAILABLE_HINT, getMetadataWriteProperties, isMetadataWriteType, mergePreWriteWarnings, prepareEnhoCreateProperties, resolveWriteSystemType, runPreWriteLint, runRapPreflightValidation, SKTD_V2_CONTENT_TYPE, stripFmParamCommentBlock, TABL_DT_WRITE_UNAVAILABLE_HINT, TTYP_WRITE_UNAVAILABLE_HINT, tryPostSaveSyntaxCheck, vendorContentTypeForType, } from '../write-helpers.js';
 import { batchCreateResult, batchEntryResult, batchFailureMessage, failBatchEntry, } from './batch-results.js';
 import { resolveCreateTransport } from './create-transport.js';
 const FUNCTION_MODULE_MEDIA_TYPE = /^application\/vnd\.sap\.adt\.functions\.fmodules(?:\.v\d+)?\+xml\b/i;
@@ -34,7 +36,7 @@ function normalizeTransportOverride(rawTransport) {
     const value = String(rawTransport).trim();
     return value || undefined;
 }
-function prepareFunctionModuleCreateSource(name, source, parameters) {
+function prepareFunctionModuleCreateSource(name, source, parameters, language) {
     const shouldWrite = !!source || (parameters !== undefined && parameters.length > 0);
     if (!shouldWrite)
         return { shouldWrite: false, source: '', warnings: [] };
@@ -43,13 +45,16 @@ function prepareFunctionModuleCreateSource(name, source, parameters) {
     if (parameters !== undefined) {
         const baseSource = !prepared || prepared.trim() === ''
             ? `FUNCTION ${name}.\nENDFUNCTION.\n`
-            : /^\s*FUNCTION\s+/i.test(prepared)
+            : findFmHeader(prepared)
                 ? prepared
                 : `FUNCTION ${name}.\n${prepared}\nENDFUNCTION.\n`;
         try {
-            prepared = spliceFmSignature(baseSource, name, parameters);
+            prepared = spliceFmSignature(baseSource, name, parameters, language);
         }
-        catch {
+        catch (error) {
+            // Explicit descriptions must never be silently dropped by the legacy source fallback.
+            if (parameters.some((parameter) => parameter.description !== undefined))
+                throw error;
             prepared = baseSource;
             warnings.push('Could not splice structured parameters into the FUNCTION source. Used the source without structured parameter changes.');
         }
@@ -148,6 +153,25 @@ async function putTtypMetadataAfterCreate(client, objectUrl, name, body, content
         throw new Error(ttypPostCreateFailureMessage(name, err));
     }
 }
+/**
+ * ENHO create, step 2 (as Eclipse does it): the POST created the empty container; save the BAdI
+ * implementations with lock → PUT (with the transport) → unlock. Posting them with the create fails in a
+ * transportable package (live 816, 2026-10-07; see badiContainerXml).
+ */
+async function saveBadiImplementationsAfterCreate(client, objectUrl, name, body, contentType, transport, minimalErrors) {
+    if (!hasBadiImplementations(body))
+        return;
+    try {
+        await safeUpdateObject(client.http, client.safety, objectUrl, body, contentType, transport, getCachedFeatures()?.abapRelease);
+    }
+    catch (err) {
+        // The POST already succeeded: the object exists. A blind retry of create would 409.
+        throw new Error(`Created ENHO ${name}, but saving or unlocking failed; the resulting state is unconfirmed. ` +
+            `The object exists — check it with SAPRead(type="ENHO", name="${name}"), then use ` +
+            `SAPWrite(action="update", type="ENHO", name="${name}", source=…) if needed; do not retry create.\n` +
+            batchFailureMessage(err, minimalErrors));
+    }
+}
 const KTD_REF_OBJECT_TYPES_ROUTABLE_BY_ARC = new Set([
     'BDEF/BAC',
     'BDEF/BAE',
@@ -163,12 +187,6 @@ const KTD_REF_OBJECT_TYPES_ROUTABLE_BY_ARC = new Set([
     'SRVB/SVB',
     'SRVD/SRV',
 ]);
-// Parent types without a canonical ARC-1 object type (no objectBasePath case); the KTD parent
-// adtcore:uri is built from this base path. SMBC = Business Configuration Maintenance Object,
-// ADT returns /sap/bc/adt/bct/smbctyp/<name> for it (e.g. in package object listings).
-const KTD_PARENT_BASE_PATHS = {
-    SMBC: '/sap/bc/adt/bct/smbctyp/',
-};
 // Live WBOBJTYPES_SCOPE registry entries for SCOPE_ID = 'DOCUMENTATION' observed on
 // SAP_BASIS 758 and 816. This is diagnostic evidence, not a create allowlist:
 // KTD create still needs a verified ADT parent URI route for <sktd:refObject>.
@@ -310,6 +328,8 @@ export async function writeActionCreate(ctx) {
     // Discovery gate before any SAP call (the TTYP/DOMA gates live in write.ts, which is at its size budget).
     if (type === 'ENQU' && isLockObjectsEndpointAvailable() === false)
         return errorResult(ENQU_WRITE_UNAVAILABLE_HINT);
+    if (type === 'ENHO' && isEnhoXhbEndpointAvailable() === false)
+        return errorResult(ENHO_WRITE_UNAVAILABLE_HINT);
     // FUNC and FUGR structural includes both INHERIT the parent group's package — SAP ignores
     // _package for them — so the allowlist must be checked against the group's real package.
     // Gating on args.package here would let a caller write into a disallowed package by claiming $TMP.
@@ -372,18 +392,17 @@ export async function writeActionCreate(ctx) {
             return errorResult(`SKTD name "${name}" must match refObjectName "${refName}" — a Knowledge Transfer Document inherits the name of the ABAP object it documents (one KTD per object). To document "${refName}", call SAPWrite(action="create", type="SKTD", name="${refName}", refObjectType="${refType}", ...).`);
         }
         const refDescription = String(args.refObjectDescription ?? '');
-        // SAP_BASIS 758 rejects an empty SMBC parent description with only "Check of condition failed".
-        if (refType === 'SMBC/TYP' && !refDescription.trim()) {
-            return errorResult('"refObjectDescription" is required for SMBC/TYP KTD creation. Provide the business configuration description.');
-        }
         // Build the parent URI. ADT URIs use lowercase names by convention (matches the Eclipse trace).
         const refParentType = refType.split('/')[0] ?? '';
-        const refUri = `${KTD_PARENT_BASE_PATHS[refParentType] ?? objectBasePath(refParentType)}${encodeURIComponent(refName.toLowerCase())}`;
+        const refUri = `${objectBasePath(refParentType)}${encodeURIComponent(refName.toLowerCase())}`;
+        // SADT_OBJECT_REFERENCE reads adtcore:description under check="not-initial(...)": an empty
+        // attribute fails with "Check of condition failed"; an absent one is skipped.
+        const refDescriptionAttr = refDescription.trim() ? ` adtcore:description="${escapeXmlAttr(refDescription)}"` : '';
         const ktdLang = normalizeAdtLanguage(config.language);
         const ktdBody = `<?xml version="1.0" encoding="UTF-8"?>
 <sktd:docu xmlns:sktd="http://www.sap.com/wbobj/texts/sktd" xmlns:adtcore="http://www.sap.com/adt/core" adtcore:language="${ktdLang}" adtcore:name="${escapeXmlAttr(name)}" adtcore:type="SKTD/TYP" adtcore:masterLanguage="${ktdLang}">
   <adtcore:packageRef adtcore:name="${escapeXmlAttr(pkg)}"/>
-  <sktd:refObject adtcore:description="${escapeXmlAttr(refDescription)}" adtcore:name="${escapeXmlAttr(refName)}" adtcore:type="${escapeXmlAttr(refType)}" adtcore:uri="${escapeXmlAttr(refUri)}"/>
+  <sktd:refObject${refDescriptionAttr} adtcore:name="${escapeXmlAttr(refName)}" adtcore:type="${escapeXmlAttr(refType)}" adtcore:uri="${escapeXmlAttr(refUri)}"/>
 </sktd:docu>`;
         const ktdCreateUrl = '/sap/bc/adt/documentation/ktd/documents';
         let ktdResult;
@@ -432,7 +451,7 @@ export async function writeActionCreate(ctx) {
     // Prepare and lint before creating metadata: rejection must not leave an empty object
     // or transport entry. FUNC parameters can synthesize source even when source is omitted.
     const funcPreparation = type === 'FUNC'
-        ? prepareFunctionModuleCreateSource(name, source, args.parameters)
+        ? prepareFunctionModuleCreateSource(name, source, args.parameters, await resolveFmDescriptionLanguage(client, groupArg, args.parameters))
         : { shouldWrite: !!source, source: source ?? '', warnings: [] };
     const shouldWriteSource = funcPreparation.shouldWrite;
     const lintWarnings = runPreWriteLint(funcPreparation.source, type, name, config, lintOverride);
@@ -447,6 +466,8 @@ export async function writeActionCreate(ctx) {
     const systemType = resolveWriteSystemType(config, client);
     const cloud = systemType === 'btp';
     const responsible = config.username || (await client.getEffectiveUser());
+    if (type === 'ENHO')
+        await prepareEnhoCreateProperties(client, metadataProperties, name);
     const body = buildCreateXml(type, name, pkg, description, metadataProperties, config.language, responsible, cloud);
     // Step 1: Create the object (metadata only)
     const createUrl = objectUrl.replace(/\/[^/]+$/, ''); // parent collection URL
@@ -457,7 +478,7 @@ export async function writeActionCreate(ctx) {
     const needsPackageParam = type === 'BDEF' || type === 'TABL' || type === 'TABL/DT' || type === 'TABL/DS';
     let result;
     try {
-        result = await createObject(client.http, client.safety, createUrl, body, contentType, effectiveTransport, needsPackageParam ? pkg : undefined, getCachedFeatures()?.abapRelease, systemType, name);
+        result = await createObject(client.http, client.safety, createUrl, type === 'ENHO' ? badiContainerXml(body) : body, contentType, effectiveTransport, needsPackageParam ? pkg : undefined, getCachedFeatures()?.abapRelease, systemType, name);
     }
     catch (createErr) {
         if (createErr instanceof AdtApiError && (createErr.statusCode === 400 || createErr.statusCode === 409)) {
@@ -515,6 +536,16 @@ export async function writeActionCreate(ctx) {
                 }
             });
         }
+        if (type === 'ENHO') {
+            try {
+                const ct = vendorContentTypeForType(type);
+                await saveBadiImplementationsAfterCreate(client, objectUrl, name, body, ct, effectiveTransport, config.minimalErrors);
+            }
+            catch (err) {
+                invalidateWrittenObject(type, name);
+                return errorResult(err instanceof Error ? err.message : String(err));
+            }
+        }
         // TTYP: the POST creates a default-typed (CHAR) shell — a follow-up PUT writes the real row type.
         if (type === 'TTYP') {
             const ct = vendorContentTypeForType(type);
@@ -525,7 +556,9 @@ export async function writeActionCreate(ctx) {
             ? `\n\nNext steps:\n1. SAPActivate(type="SRVB", name="${name}")\n2. SAPActivate(action="publish_srvb", name="${name}")`
             : type === 'ENQU'
                 ? `\n\nNext step: SAPActivate(type="ENQU", name="${name}") — activation generates ENQUEUE_${name}/DEQUEUE_${name}.`
-                : '';
+                : type === 'ENHO'
+                    ? `\n\nNext step: activate the implementing class(es), then SAPActivate(type="ENHO", name="${name}").`
+                    : '';
         return textResult(`Created ${type} ${name} in package ${pkg}.\n${result}${followUpHint}`);
     }
     // Step 2: Write the already-validated source if provided.
@@ -614,6 +647,8 @@ export async function writeActionBatchCreate(ctx) {
                 errors.push(TTYP_WRITE_UNAVAILABLE_HINT);
             if (plan.type === 'ENQU' && isLockObjectsEndpointAvailable() === false)
                 errors.push(ENQU_WRITE_UNAVAILABLE_HINT);
+            if (plan.type === 'ENHO' && isEnhoXhbEndpointAvailable() === false)
+                errors.push(ENHO_WRITE_UNAVAILABLE_HINT);
             if (plan.type === 'INCL' && plan.name.startsWith('L')) {
                 errors.push('Function-group structural includes require a single SAPWrite create with group; batch_create does not support them.');
             }
@@ -621,7 +656,7 @@ export async function writeActionBatchCreate(ctx) {
             if (!aff.valid)
                 errors.push(`AFF metadata validation failed:\n- ${(aff.errors ?? []).join('\n- ')}`);
             if (plan.type === 'FUNC') {
-                const prepared = prepareFunctionModuleCreateSource(plan.name, plan.source, plan.obj.parameters);
+                const prepared = prepareFunctionModuleCreateSource(plan.name, plan.source, plan.obj.parameters, await resolveFmDescriptionLanguage(client, plan.group ?? '', plan.obj.parameters));
                 plan.source = prepared.shouldWrite ? prepared.source : undefined;
                 warnings.push(...prepared.warnings.map((warning) => `${plan.type} ${plan.name}: ${warning}`));
             }
@@ -646,6 +681,7 @@ export async function writeActionBatchCreate(ctx) {
             }
             if (plan.type === 'DTEL' ||
                 plan.type === 'TTYP' ||
+                plan.type === 'ENHO' ||
                 (plan.type === 'FUNC' && plan.metadata.processingType !== undefined) ||
                 (!plan.metadataObject && plan.source)) {
                 plan.result.write = 'not_attempted';
@@ -714,12 +750,14 @@ export async function writeActionBatchCreate(ctx) {
         }
         try {
             applyBdefBehaviorExtensionMetadata(plan.type, plan.source, plan.metadata);
+            if (plan.type === 'ENHO')
+                await prepareEnhoCreateProperties(client, plan.metadata, plan.name);
             plan.body = buildCreateXml(plan.type, plan.name, plan.packageName, plan.description, plan.metadata, config.language, responsible, cloud);
             plan.contentType = createContentTypeForType(plan.type, cloud);
         }
         catch (err) {
-            // Construction errors are local input diagnostics, not SAP response details.
-            failBatchEntry(plan.result, 'preflight', batchFailureMessage(err, false));
+            // Construction errors are local input diagnostics, except the ENHO spot read, which is a SAP response.
+            failBatchEntry(plan.result, 'preflight', batchFailureMessage(err, err instanceof AdtApiError && config.minimalErrors));
         }
     }
     if (results.some((entry) => entry.status === 'failed'))
@@ -732,7 +770,7 @@ export async function writeActionBatchCreate(ctx) {
             const needsPackage = plan.type === 'BDEF' || canonicalTablType(plan.type) === 'TABL';
             entry.creation = 'unknown';
             try {
-                await createObject(client.http, client.safety, plan.objectUrl.replace(/\/[^/]+$/, ''), plan.body, plan.contentType, plan.transport, needsPackage ? plan.packageName : undefined, getCachedFeatures()?.abapRelease, systemType, plan.name);
+                await createObject(client.http, client.safety, plan.objectUrl.replace(/\/[^/]+$/, ''), plan.type === 'ENHO' ? badiContainerXml(plan.body) : plan.body, plan.contentType, plan.transport, needsPackage ? plan.packageName : undefined, getCachedFeatures()?.abapRelease, systemType, plan.name);
             }
             catch (err) {
                 if (err instanceof AdtSafetyError)
@@ -752,6 +790,8 @@ export async function writeActionBatchCreate(ctx) {
             if (plan.type === 'FUNC' && plan.metadata.processingType !== undefined) {
                 await persistFunctionModuleProcessingMetadata(client, plan.objectUrl, plan.name, plan.metadata.processingType, plan.metadata.updateTaskKind, plan.transport);
             }
+            if (plan.type === 'ENHO')
+                await saveBadiImplementationsAfterCreate(client, plan.objectUrl, plan.name, plan.body, plan.contentType, plan.transport, config.minimalErrors);
             if (plan.type === 'DTEL') {
                 await client.http.withStatefulSession(async (session) => {
                     const lock = await lockObject(session, client.safety, plan.objectUrl, 'MODIFY', getCachedFeatures()?.abapRelease);
@@ -776,7 +816,9 @@ export async function writeActionBatchCreate(ctx) {
             else {
                 phase = 'activate';
                 entry.activation = 'unknown';
-                const outcome = await activate(client.http, client.safety, plan.objectUrl);
+                // Send the name like SAPActivate does: ENHO activation fails with 403 "Resource   could not be
+                // locked" when the reference carries only the URI (live 816, 2026-10-07).
+                const outcome = await activate(client.http, client.safety, plan.objectUrl, { name: plan.name });
                 if (!outcome.success) {
                     entry.activation = 'failed';
                     failBatchEntry(entry, phase, `activation failed: ${batchFailureMessage(outcome.messages.join('; '), config.minimalErrors)}`);