@linkup-ai/abap-ai 0.1.0

package/dist/tools/scaffold-rap.js

@@ -0,0 +1,642 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abapScaffoldRap = abapScaffoldRap;
+const create_js_1 = require("./create.js");
+const write_js_1 = require("./write.js");
+const activate_js_1 = require("./activate.js");
+const system_profile_js_1 = require("../system-profile.js");
+// ---------------------------------------------------------------------------
+// Step runner
+// ---------------------------------------------------------------------------
+async function run(steps, step, objectName, objectType, fn) {
+    try {
+        await fn();
+        steps.push({ step, object: objectName, type: objectType, status: "ok", message: "OK" });
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        steps.push({ step, object: objectName, type: objectType, status: "error", message });
+        return false;
+    }
+}
+function formatSummary(steps, success, warnings) {
+    const header = success
+        ? "✅ Stack RAP criado com sucesso!\n"
+        : "⚠️ Stack RAP criado parcialmente — verifique os erros abaixo:\n";
+    const rows = steps.map((s) => {
+        const icon = s.status === "ok" ? "✓" : "✗";
+        return `  ${icon} [${s.step.padEnd(8)}] ${s.type.padEnd(10)} ${s.object}${s.status === "error" ? ` ERRO: ${s.message}` : ""}`;
+    });
+    const warnBlock = warnings.length > 0 ? warnings.join("\n") + "\n\n" : "";
+    return warnBlock + header + rows.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helper: create + write + activate
+// ---------------------------------------------------------------------------
+async function createObject(steps, name, type, desc, pkg, tr, srvdName, bindingType) {
+    return run(steps, "create", name, type, () => (0, create_js_1.abapCreate)({ object_type: type, object_name: name, description: desc, package: pkg, transport_request: tr, srvd_name: srvdName, binding_type: bindingType }).then(() => undefined));
+}
+async function writeSource(steps, name, type, source) {
+    return run(steps, "write", name, type, () => (0, write_js_1.abapWrite)({ object_type: type, object_name: name, source }).then(() => undefined));
+}
+async function activateObject(steps, name, type) {
+    return run(steps, "activate", name, type, () => (0, activate_js_1.abapActivate)({ object_type: type, object_name: name }).then(() => undefined));
+}
+// Shortcut: create + write + activate
+async function createWriteActivate(steps, name, type, desc, source, pkg, tr) {
+    if (!(await createObject(steps, name, type, desc, pkg, tr)))
+        return false;
+    if (!(await writeSource(steps, name, type, source)))
+        return false;
+    if (!(await activateObject(steps, name, type)))
+        return false;
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Templates
+// ---------------------------------------------------------------------------
+function tplCdsInterfaceRoot(name, desc, tableName, childEntities) {
+    const compositions = childEntities.map((c) => `  composition [0..*] of ${c} as _${aliasFrom(c)}`).join("\n");
+    const compFields = childEntities.map((c) => `      _${aliasFrom(c)}`).join(",\n");
+    return `@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+@EndUserText.label: '${desc}'
+
+define root view entity ${name}
+  as select from ${tableName.toLowerCase()}
+${compositions ? compositions + "\n" : ""}{
+  key key_field as KeyField
+}`;
+    // NOTE: Este é um template mínimo ativável.
+    // O Claude deve usar abap_knowledge('rap-end-to-end') para gerar o CDS completo
+    // com os campos reais da tabela e depois sobrescrever com abap_write.
+}
+function tplCdsInterfaceChild(name, desc, tableName, parentName) {
+    return `@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+@EndUserText.label: '${desc}'
+
+define view entity ${name}
+  as select from ${tableName.toLowerCase()}
+  association to parent ${parentName} as _${aliasFrom(parentName)}
+    on $projection.ParentKey = _${aliasFrom(parentName)}.KeyField
+{
+  key parent_key as ParentKey,
+  key item_key   as ItemKey,
+      _${aliasFrom(parentName)}
+}`;
+}
+function tplBdefManaged(rootCds, childCds, withDraft, withFeatureControl, events) {
+    const handlerClass = `zbp_${rootCds.toLowerCase()}`;
+    const lines = [];
+    lines.push(`managed implementation in class ${handlerClass} unique;`);
+    lines.push("strict ( 2 );");
+    if (withDraft)
+        lines.push("with draft;");
+    lines.push("");
+    // Root entity
+    lines.push(`define behavior for ${rootCds} alias ${aliasFrom(rootCds)}`);
+    lines.push(`persistent table ${rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_")}`);
+    if (withDraft)
+        lines.push(`draft table ${rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_")}_d`);
+    lines.push("etag master LocalLastChangedAt");
+    if (withDraft) {
+        lines.push("lock master total etag LastChangedAt");
+    }
+    else {
+        lines.push("lock master");
+    }
+    lines.push("authorization master ( global )");
+    lines.push("{");
+    lines.push("  field ( readonly ) KeyField;");
+    lines.push("  field ( readonly ) CreatedBy, CreatedAt, LastChangedBy, LastChangedAt, LocalLastChangedAt;");
+    lines.push("");
+    lines.push("  create;");
+    lines.push("  update;");
+    lines.push("  delete;");
+    if (withDraft) {
+        lines.push("");
+        lines.push("  draft action Edit;");
+        lines.push("  draft action Activate optimized;");
+        lines.push("  draft action Discard;");
+        lines.push("  draft action Resume;");
+        lines.push("  draft determine action Prepare { }");
+    }
+    if (withFeatureControl) {
+        lines.push("");
+        lines.push("  // Feature control — ajuste as actions e fields conforme necessário");
+        lines.push("  // action ( features : instance ) myAction result [1] $self;");
+        lines.push("  // field ( features : instance ) Status;");
+    }
+    if (events.length > 0) {
+        lines.push("");
+        for (const evt of events) {
+            lines.push(`  event ${evt};`);
+        }
+    }
+    lines.push("");
+    lines.push(`  mapping for ${rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_")} corresponding;`);
+    for (const child of childCds) {
+        if (withDraft) {
+            lines.push(`  association _${aliasFrom(child)} { create; with draft; }`);
+        }
+        else {
+            lines.push(`  association _${aliasFrom(child)} { create; }`);
+        }
+    }
+    lines.push("}");
+    // Child entities
+    for (const child of childCds) {
+        lines.push("");
+        lines.push(`define behavior for ${child} alias ${aliasFrom(child)}`);
+        lines.push(`persistent table ${child.toLowerCase().replace(/^z[ic]_/, "ztab_")}`);
+        if (withDraft)
+            lines.push(`draft table ${child.toLowerCase().replace(/^z[ic]_/, "ztab_")}_d`);
+        lines.push("etag master LocalLastChangedAt");
+        lines.push(`lock dependent by _${aliasFrom(rootCds)}`);
+        lines.push(`authorization dependent by _${aliasFrom(rootCds)}`);
+        lines.push("{");
+        lines.push("  update;");
+        lines.push("  delete;");
+        lines.push("");
+        lines.push(`  mapping for ${child.toLowerCase().replace(/^z[ic]_/, "ztab_")} corresponding;`);
+        if (withDraft) {
+            lines.push(`  association _${aliasFrom(rootCds)} { with draft; }`);
+        }
+        else {
+            lines.push(`  association _${aliasFrom(rootCds)};`);
+        }
+        lines.push("}");
+    }
+    return lines.join("\n");
+}
+function tplBdefUnmanaged(rootCds, childCds) {
+    const handlerClass = `zbp_${rootCds.toLowerCase()}`;
+    const lines = [];
+    lines.push(`unmanaged implementation in class ${handlerClass} unique;`);
+    lines.push("strict ( 2 );");
+    lines.push("");
+    lines.push(`define behavior for ${rootCds} alias ${aliasFrom(rootCds)}`);
+    lines.push("lock master");
+    lines.push("authorization master ( instance )");
+    lines.push("etag master LocalLastChangedAt");
+    lines.push("{");
+    lines.push("  create;");
+    lines.push("  update;");
+    lines.push("  delete;");
+    lines.push("");
+    lines.push(`  mapping for ${rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_")} corresponding;`);
+    for (const child of childCds) {
+        lines.push(`  association _${aliasFrom(child)} { create; }`);
+    }
+    lines.push("}");
+    for (const child of childCds) {
+        lines.push("");
+        lines.push(`define behavior for ${child} alias ${aliasFrom(child)}`);
+        lines.push(`lock dependent by _${aliasFrom(rootCds)}`);
+        lines.push(`authorization dependent by _${aliasFrom(rootCds)}`);
+        lines.push("{");
+        lines.push("  update;");
+        lines.push("  delete;");
+        lines.push(`  mapping for ${child.toLowerCase().replace(/^z[ic]_/, "ztab_")} corresponding;`);
+        lines.push(`  association _${aliasFrom(rootCds)};`);
+        lines.push("}");
+    }
+    return lines.join("\n");
+}
+function tplHandlerClass(rootCds) {
+    const className = `zbp_${rootCds.toLowerCase()}`;
+    return `CLASS ${className} DEFINITION PUBLIC ABSTRACT FINAL FOR BEHAVIOR OF ${rootCds}.
+ENDCLASS.
+CLASS ${className} IMPLEMENTATION.
+ENDCLASS.`;
+}
+function tplHandlerClassUnmanaged(rootCds) {
+    const className = `zbp_${rootCds.toLowerCase()}`;
+    const alias = aliasFrom(rootCds);
+    return `CLASS ${className} DEFINITION PUBLIC ABSTRACT FINAL FOR BEHAVIOR OF ${rootCds}.
+  PUBLIC SECTION.
+    " Buffer compartilhado entre handler e saver
+    CLASS-DATA: gt_create TYPE STANDARD TABLE OF ${rootCds.toLowerCase().replace(/^z[ic]_/, "zs_")}_create,
+                gt_update TYPE STANDARD TABLE OF ${rootCds.toLowerCase().replace(/^z[ic]_/, "zs_")}_update,
+                gt_delete TYPE STANDARD TABLE OF ${rootCds.toLowerCase().replace(/^z[ic]_/, "zs_")}_delete.
+ENDCLASS.
+CLASS ${className} IMPLEMENTATION.
+ENDCLASS.`;
+}
+function tplCdsProjectionRoot(projName, interfaceName, desc, childProj, childIntf) {
+    const lines = [];
+    lines.push(`@AccessControl.authorizationCheck: #CHECK`);
+    lines.push(`@Metadata.allowExtensions: true`);
+    lines.push(`@Search.searchable: true`);
+    lines.push(`@EndUserText.label: '${desc}'`);
+    lines.push("");
+    lines.push(`define root view entity ${projName}`);
+    lines.push(`  provider contract transactional_query`);
+    lines.push(`  as projection on ${interfaceName}`);
+    lines.push("{");
+    lines.push("  key KeyField,");
+    // Redirect child compositions
+    for (let i = 0; i < childProj.length; i++) {
+        lines.push(`      _${aliasFrom(childIntf[i])} : redirected to composition child ${childProj[i]},`);
+    }
+    lines.push("      CreatedBy, CreatedAt, LastChangedBy, LastChangedAt, LocalLastChangedAt");
+    lines.push("}");
+    return lines.join("\n");
+}
+function tplCdsProjectionChild(projName, interfaceName, desc, parentProj, parentIntf) {
+    return `@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+@EndUserText.label: '${desc}'
+
+define view entity ${projName}
+  as projection on ${interfaceName}
+{
+  key ParentKey,
+  key ItemKey,
+      _${aliasFrom(parentIntf)} : redirected to parent ${parentProj},
+      LocalLastChangedAt
+}`;
+}
+function tplProjectionBdef(projRoot, childProj, childIntf, withDraft) {
+    const lines = [];
+    lines.push("projection;");
+    lines.push("strict ( 2 );");
+    if (withDraft)
+        lines.push("use draft;");
+    lines.push("");
+    lines.push(`define behavior for ${projRoot} alias ${aliasFrom(projRoot)}`);
+    lines.push("use etag");
+    lines.push("{");
+    lines.push("  use create; use update; use delete;");
+    if (withDraft) {
+        lines.push("  use action Edit; use action Activate; use action Discard;");
+        lines.push("  use action Resume; use action Prepare;");
+    }
+    for (let i = 0; i < childProj.length; i++) {
+        if (withDraft) {
+            lines.push(`  use association _${aliasFrom(childIntf[i])} { create; with draft; }`);
+        }
+        else {
+            lines.push(`  use association _${aliasFrom(childIntf[i])} { create; }`);
+        }
+    }
+    lines.push("}");
+    for (let i = 0; i < childProj.length; i++) {
+        lines.push("");
+        lines.push(`define behavior for ${childProj[i]} alias ${aliasFrom(childProj[i])}`);
+        lines.push("use etag");
+        lines.push("{");
+        lines.push("  use update; use delete;");
+        if (withDraft) {
+            lines.push(`  use association _${aliasFrom(projRoot.replace(/^zc_/i, "zi_"))} { with draft; }`);
+        }
+        else {
+            lines.push(`  use association _${aliasFrom(projRoot.replace(/^zc_/i, "zi_"))};`);
+        }
+        lines.push("}");
+    }
+    return lines.join("\n");
+}
+function tplServiceDefinition(srvdName, desc, projRoot, childProj) {
+    const lines = [];
+    lines.push(`@EndUserText.label: '${desc}'`);
+    lines.push(`define service ${srvdName} {`);
+    lines.push(`  expose ${projRoot} as ${aliasFrom(projRoot)};`);
+    for (const child of childProj) {
+        lines.push(`  expose ${child} as ${aliasFrom(child)};`);
+    }
+    lines.push("}");
+    return lines.join("\n");
+}
+function tplMetadataExtension(ddlxName, projRoot) {
+    return `@Metadata.layer: #CORE
+annotate entity ${projRoot} with
+{
+  @UI.facet: [
+    { id: 'General', type: #IDENTIFICATION_REFERENCE, label: 'General', position: 10 }
+  ]
+
+  @UI.hidden: true
+  KeyField;
+}`;
+}
+function tplCdsAbstractEntity(name, desc) {
+    return `@EndUserText.label: '${desc}'
+define abstract entity ${name}
+{
+  key_field : abap.char(40);
+}`;
+}
+function tplCdsCustomEntity(name, desc, queryClass) {
+    return `@EndUserText.label: '${desc}'
+@ObjectModel.query.implementedBy: 'ABAP:${queryClass.toUpperCase()}'
+define custom entity ${name}
+{
+  key KeyField : abap.char(40);
+      Value    : abap.char(100);
+}`;
+}
+function tplQueryClass(className) {
+    return `CLASS ${className.toLowerCase()} DEFINITION PUBLIC FINAL CREATE PUBLIC.
+  PUBLIC SECTION.
+    INTERFACES if_rap_query_provider.
+ENDCLASS.
+
+CLASS ${className.toLowerCase()} IMPLEMENTATION.
+  METHOD if_rap_query_provider~select.
+    DATA(lv_top) = io_request->get_paging( )->get_page_size( ).
+    DATA(lv_skip) = io_request->get_paging( )->get_offset( ).
+
+    " TODO: Implementar query — use abap_knowledge('abap/rap-unmanaged') como referência
+
+    io_response->set_data( VALUE #( ) ).
+    IF io_request->is_total_numb_of_rec_requested( ).
+      io_response->set_total_number_of_records( 0 ).
+    ENDIF.
+  ENDMETHOD.
+ENDCLASS.`;
+}
+// Extract alias from CDS name: ZI_Travel → Travel, ZC_Booking → Booking
+function aliasFrom(cdsName) {
+    // Remove prefix ZI_, ZC_, ZA_, ZCE_ etc.
+    return cdsName.replace(/^Z[A-Z]{0,2}_/i, "");
+}
+// ---------------------------------------------------------------------------
+// Scenarios
+// ---------------------------------------------------------------------------
+async function scenarioManaged(input) {
+    const { base_name, description, package: pkg = "$TMP", binding_type = "ODATA;V4;UI", transport_request: tr } = input;
+    const name = base_name.toUpperCase();
+    const srvdName = `SRVD_${name}`;
+    const srvbName = `SRVB_${name}`;
+    const steps = [];
+    const warnings = collectWarnings(binding_type);
+    // CDS
+    const cdsSource = `@AbapCatalog.viewEnhancementCategory: [#NONE]
+@AccessControl.authorizationCheck: #NOT_REQUIRED
+@EndUserText.label: '${description}'
+@Metadata.ignorePropagatedAnnotations: true
+@Metadata.allowExtensions: true
+
+define root view entity ${name}
+  as select from I_BusinessPartner
+{
+  key BusinessPartner
+}`;
+    if (!(await createWriteActivate(steps, name, "DDLS/DF", description, cdsSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // BDEF
+    const bdefSource = `managed implementation in class zbp_${name.toLowerCase()} unique;
+strict ( 2 );
+
+define behavior for ${name}
+{
+}`;
+    if (!(await createWriteActivate(steps, name, "BDEF/BDO", description, bdefSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // SRVD
+    if (!(await createObject(steps, srvdName, "SRVD/SRV", `${description} - Service Def`, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    if (!(await activateObject(steps, srvdName, "SRVD/SRV"))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // SRVB
+    if (!(await createObject(steps, srvbName, "SRVB/SVB", `${description} - Service Binding`, pkg, tr, srvdName, binding_type))) {
+        return formatSummary(steps, false, warnings);
+    }
+    await activateObject(steps, srvbName, "SRVB/SVB");
+    return formatSummary(steps, steps.every((s) => s.status === "ok"), warnings);
+}
+async function scenarioManagedDraft(input) {
+    const { base_name, description, child_entities = [], with_feature_control: wfc = false, with_business_events: events = [], package: pkg = "$TMP", binding_type = "ODATA;V4;UI", transport_request: tr, } = input;
+    const rootCds = base_name.toUpperCase();
+    const childCds = child_entities.map((c) => c.toUpperCase());
+    const rootProj = rootCds.replace(/^ZI_/i, "ZC_");
+    const childProj = childCds.map((c) => c.replace(/^ZI_/i, "ZC_"));
+    const srvdName = `SRVD_${rootCds.replace(/^ZI_/i, "")}`;
+    const srvbName = `SRVB_${rootCds.replace(/^ZI_/i, "")}`;
+    const ddlxName = `${rootProj}`;
+    const handlerClassName = `zbp_${rootCds.toLowerCase()}`;
+    const steps = [];
+    const warnings = collectWarnings(binding_type);
+    // 1. CDS Interface Root
+    const cdsRootSource = tplCdsInterfaceRoot(rootCds, description, rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_"), childCds);
+    if (!(await createWriteActivate(steps, rootCds, "DDLS/DF", `${description} - Interface`, cdsRootSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 2. CDS Interface Children
+    for (const child of childCds) {
+        const childTable = child.toLowerCase().replace(/^z[ic]_/, "ztab_");
+        const childSource = tplCdsInterfaceChild(child, `${description} - ${aliasFrom(child)}`, childTable, rootCds);
+        if (!(await createWriteActivate(steps, child, "DDLS/DF", `${description} - ${aliasFrom(child)}`, childSource, pkg, tr))) {
+            return formatSummary(steps, false, warnings);
+        }
+    }
+    // 3. BDEF Interface
+    const bdefSource = tplBdefManaged(rootCds, childCds, true, wfc, events);
+    if (!(await createWriteActivate(steps, rootCds, "BDEF/BDO", description, bdefSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 4. Handler Class
+    const handlerSource = tplHandlerClass(rootCds);
+    if (!(await createWriteActivate(steps, handlerClassName.toUpperCase(), "CLAS/OC", `${description} - Handler`, handlerSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 5. CDS Projection Root
+    const projRootSource = tplCdsProjectionRoot(rootProj, rootCds, `${description} - Projection`, childProj, childCds);
+    if (!(await createWriteActivate(steps, rootProj, "DDLS/DF", `${description} - Projection`, projRootSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 6. CDS Projection Children
+    for (let i = 0; i < childCds.length; i++) {
+        const childProjSource = tplCdsProjectionChild(childProj[i], childCds[i], `${description} - ${aliasFrom(childProj[i])}`, rootProj, rootCds);
+        if (!(await createWriteActivate(steps, childProj[i], "DDLS/DF", `${description} - ${aliasFrom(childProj[i])}`, childProjSource, pkg, tr))) {
+            return formatSummary(steps, false, warnings);
+        }
+    }
+    // 7. Projection BDEF
+    const projBdefSource = tplProjectionBdef(rootProj, childProj, childCds, true);
+    if (!(await createWriteActivate(steps, rootProj, "BDEF/BDO", `${description} - Proj BDEF`, projBdefSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 8. Service Definition
+    const srvdSource = tplServiceDefinition(srvdName, description, rootProj, childProj);
+    if (!(await createObject(steps, srvdName, "SRVD/SRV", `${description} - Service Def`, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // SRVD source is auto-generated, just activate
+    if (!(await activateObject(steps, srvdName, "SRVD/SRV"))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 9. Service Binding
+    if (!(await createObject(steps, srvbName, "SRVB/SVB", `${description} - Service Binding`, pkg, tr, srvdName, binding_type))) {
+        return formatSummary(steps, false, warnings);
+    }
+    await activateObject(steps, srvbName, "SRVB/SVB");
+    // 10. Metadata Extension
+    const ddlxSource = tplMetadataExtension(ddlxName, rootProj);
+    // DDLX uses the projection name
+    const ddlxObjName = `${rootProj}_MDE`;
+    if (!(await createWriteActivate(steps, ddlxObjName, "DDLX/MX", `${description} - UI Annotations`, ddlxSource, pkg, tr))) {
+        // DDLX failure is non-fatal
+        warnings.push("AVISO: Metadata Extension falhou — pode ser criada manualmente depois.");
+    }
+    const success = steps.filter((s) => s.status === "error").length === 0 ||
+        (steps.filter((s) => s.status === "error").length === 1 && steps[steps.length - 1]?.status === "error");
+    const summary = formatSummary(steps, steps.every((s) => s.status === "ok"), warnings);
+    // Add next steps guidance
+    const nextSteps = [
+        "",
+        "",
+        "📋 Próximos passos:",
+        "  1. Ajustar campos do CDS Interface com abap_write (use abap_knowledge action:'get' topics:['abap/rap-end-to-end'])",
+        "  2. Adicionar validations/determinations no BDEF",
+        "  3. Implementar handler class locals_def/locals_imp (use abap_knowledge action:'get' topics:['abap/rap-eml'])",
+        "  4. Ajustar Metadata Extension para UI (use abap_knowledge action:'get' topics:['abap-cds/metadata-extensions'])",
+        wfc ? "  5. Implementar get_instance_features (use abap_knowledge action:'get' topics:['abap/rap-feature-control'])" : "",
+        events.length > 0 ? "  6. Implementar RAISE ENTITY EVENT (use abap_knowledge action:'get' topics:['abap/rap-business-events'])" : "",
+    ].filter(Boolean);
+    return summary + nextSteps.join("\n");
+}
+async function scenarioUnmanaged(input) {
+    const { base_name, description, child_entities = [], package: pkg = "$TMP", binding_type = "ODATA;V4;UI", transport_request: tr, } = input;
+    const rootCds = base_name.toUpperCase();
+    const childCds = child_entities.map((c) => c.toUpperCase());
+    const rootProj = rootCds.replace(/^ZI_/i, "ZC_");
+    const childProj = childCds.map((c) => c.replace(/^ZI_/i, "ZC_"));
+    const srvdName = `SRVD_${rootCds.replace(/^ZI_/i, "")}`;
+    const srvbName = `SRVB_${rootCds.replace(/^ZI_/i, "")}`;
+    const handlerClassName = `zbp_${rootCds.toLowerCase()}`;
+    const steps = [];
+    const warnings = collectWarnings(binding_type);
+    // 1. CDS Interface Root
+    const cdsRootSource = tplCdsInterfaceRoot(rootCds, description, rootCds.toLowerCase().replace(/^z[ic]_/, "ztab_"), childCds);
+    if (!(await createWriteActivate(steps, rootCds, "DDLS/DF", `${description} - Interface`, cdsRootSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 2. CDS Interface Children
+    for (const child of childCds) {
+        const childTable = child.toLowerCase().replace(/^z[ic]_/, "ztab_");
+        const childSource = tplCdsInterfaceChild(child, `${description} - ${aliasFrom(child)}`, childTable, rootCds);
+        if (!(await createWriteActivate(steps, child, "DDLS/DF", `${description} - ${aliasFrom(child)}`, childSource, pkg, tr))) {
+            return formatSummary(steps, false, warnings);
+        }
+    }
+    // 3. BDEF Unmanaged
+    const bdefSource = tplBdefUnmanaged(rootCds, childCds);
+    if (!(await createWriteActivate(steps, rootCds, "BDEF/BDO", description, bdefSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 4. Handler Class (with buffer pattern)
+    const handlerSource = tplHandlerClassUnmanaged(rootCds);
+    if (!(await createWriteActivate(steps, handlerClassName.toUpperCase(), "CLAS/OC", `${description} - Handler`, handlerSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 5. Projection CDS Root
+    const projRootSource = tplCdsProjectionRoot(rootProj, rootCds, `${description} - Projection`, childProj, childCds);
+    if (!(await createWriteActivate(steps, rootProj, "DDLS/DF", `${description} - Projection`, projRootSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 6. Projection CDS Children
+    for (let i = 0; i < childCds.length; i++) {
+        const childProjSource = tplCdsProjectionChild(childProj[i], childCds[i], `${description} - ${aliasFrom(childProj[i])}`, rootProj, rootCds);
+        if (!(await createWriteActivate(steps, childProj[i], "DDLS/DF", `${description} - ${aliasFrom(childProj[i])}`, childProjSource, pkg, tr))) {
+            return formatSummary(steps, false, warnings);
+        }
+    }
+    // 7. Projection BDEF (no draft)
+    const projBdefSource = tplProjectionBdef(rootProj, childProj, childCds, false);
+    if (!(await createWriteActivate(steps, rootProj, "BDEF/BDO", `${description} - Proj BDEF`, projBdefSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 8. Service Definition + Binding
+    if (!(await createObject(steps, srvdName, "SRVD/SRV", `${description} - Service Def`, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    if (!(await activateObject(steps, srvdName, "SRVD/SRV"))) {
+        return formatSummary(steps, false, warnings);
+    }
+    if (!(await createObject(steps, srvbName, "SRVB/SVB", `${description} - Binding`, pkg, tr, srvdName, binding_type))) {
+        return formatSummary(steps, false, warnings);
+    }
+    await activateObject(steps, srvbName, "SRVB/SVB");
+    const summary = formatSummary(steps, steps.every((s) => s.status === "ok"), warnings);
+    const nextSteps = [
+        "",
+        "",
+        "📋 Próximos passos (OBRIGATÓRIOS para unmanaged):",
+        "  1. Implementar handler methods: create, update, delete, read, lock",
+        "     → abap_knowledge(action:'get', topics:['abap/rap-unmanaged'])",
+        "  2. Implementar saver class: finalize, check_before_save, save, cleanup",
+        "  3. Se wrapping BAPI: BAPI calls vão no saver save(), NÃO no handler",
+        "  4. Ajustar campos CDS + projection com abap_write",
+    ];
+    return summary + nextSteps.join("\n");
+}
+async function scenarioQuery(input) {
+    const { base_name, description, package: pkg = "$TMP", transport_request: tr } = input;
+    const entityName = base_name.toUpperCase();
+    const queryClassName = `ZCL_${entityName.replace(/^Z(CE_|A_)?/i, "")}_QUERY`;
+    const steps = [];
+    const warnings = [];
+    // 1. Custom Entity CDS
+    const cdsSource = tplCdsCustomEntity(entityName, description, queryClassName);
+    if (!(await createWriteActivate(steps, entityName, "DDLS/DF", description, cdsSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    // 2. Query Implementation Class
+    const classSource = tplQueryClass(queryClassName);
+    if (!(await createWriteActivate(steps, queryClassName.toUpperCase(), "CLAS/OC", `${description} - Query`, classSource, pkg, tr))) {
+        return formatSummary(steps, false, warnings);
+    }
+    const summary = formatSummary(steps, steps.every((s) => s.status === "ok"), warnings);
+    const nextSteps = [
+        "",
+        "",
+        "📋 Próximos passos:",
+        "  1. Ajustar campos do custom entity com abap_write",
+        "  2. Implementar if_rap_query_provider~select na classe",
+        "     → abap_knowledge(action:'get', topics:['abap/rap-unmanaged']) seção 'Unmanaged Query'",
+        "  3. Pode ser exposto diretamente em Service Definition (sem BDEF)",
+    ];
+    return summary + nextSteps.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+function collectWarnings(bindingType) {
+    const warnings = [];
+    const profile = (0, system_profile_js_1.getProfile)();
+    if (!profile.capabilities.cdsViewEntity) {
+        warnings.push(`⚠️ O sistema ${profile.system.systemId || profile.system.type} (BASIS ${profile.system.sapBasisVersion}) pode não suportar 'define view entity'. Scaffold RAP requer S/4HANA 2020+ (BASIS 756+).`);
+    }
+    if (bindingType.includes("V4") && profile.quirks.conversionExitFields.length > 0) {
+        warnings.push(`⚠️ Em OData V4, campos com conversion exit causam erro em runtime. ` +
+            `Campos conhecidos: ${profile.quirks.conversionExitFields.join(", ")}. ` +
+            `Use cast( campo as abap.char(n) ) na CDS para evitar problemas.`);
+    }
+    return warnings;
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+async function abapScaffoldRap(input) {
+    const scenario = input.scenario || "managed";
+    switch (scenario) {
+        case "managed":
+            return scenarioManaged(input);
+        case "managed_draft":
+            return scenarioManagedDraft(input);
+        case "unmanaged":
+            return scenarioUnmanaged(input);
+        case "query":
+            return scenarioQuery(input);
+        default:
+            return `Scenario "${scenario}" inválido. Use: managed, managed_draft, unmanaged ou query.`;
+    }
+}