arc-1 0.9.2 → 0.9.4

package/dist/adt/rap-generate.d.ts

@@ -0,0 +1,110 @@
+/**
+ * High-level RAP behavior pool generator (PR-C / SAPWrite generate_behavior_implementation).
+ *
+ * One-shot equivalent of Eclipse ADT's "Generate Behavior Implementation"
+ * Cmd+1 quickfix on a behavior pool class. Composes existing capabilities:
+ *
+ *   1. parseClassMetadata.rootEntityRef  — auto-discover the bound BDEF
+ *   2. extractRapHandlerRequirements     — derive every required handler method
+ *   3. applyRapHandlerScaffold           — auto-create lhc_<alias> skeletons,
+ *                                          inject signatures + empty stubs
+ *   4. updateSource (per include URL)    — write CCDEF + CCIMP under one lock
+ *   5. activateBatch                     — optional final activation
+ *
+ * This avoids the broken `/sap/bc/adt/quickfixes/proposals/.../create_class_implementation`
+ * server endpoint (HTTP 500 on a4h regardless of payload — verified live during research).
+ * Local generation is deterministic, fully unit-testable, and reuses the proven PR #257
+ * include-write path.
+ *
+ * Inputs:
+ *   className — the behavior pool class (e.g. "ZBP_DM_PROJECT")
+ *   options.bdefName — explicit BDEF override; default is auto-discovery from rootEntityRef
+ *   options.targetAlias — restrict scaffold to one entity alias (case-insensitive)
+ *   options.activate — also run SAPActivate after writing (default true)
+ *   options.dryRun — preview without writing/activating (default false)
+ *
+ * Output:
+ *   `RapGenerateResult` carries the discovery, validation, scaffold, and activation
+ *   outcomes. Activation failures matching the "stale active CCDEF/CCIMP placeholder
+ *   + new inactive content" coupling DO NOT throw — they return `activation.success=false`
+ *   with a guided `hint` so the caller can surface the recovery path. Other activation
+ *   failures rethrow.
+ */
+import type { AdtClient } from './client.js';
+import { type RapHandlerRequirement } from './rap-handlers.js';
+/** Options for `generateBehaviorImplementation`. */
+export interface RapGenerateOptions {
+    /** Explicit BDEF name (overrides rootEntityRef auto-discovery). */
+    bdefName?: string;
+    /** Restrict scaffold to a single entity alias (case-insensitive). */
+    targetAlias?: string;
+    /** Also run `SAPActivate` on the class after writing (default `true`). */
+    activate?: boolean;
+    /** Preview the plan without writing or activating (default `false`). */
+    dryRun?: boolean;
+    /** Optional transport request to attribute writes to. */
+    transport?: string;
+}
+/** Discovery + validation diagnostics. */
+export interface RapGenerateDiscovery {
+    className: string;
+    bdefName: string;
+    /** Where the BDEF name came from. */
+    source: 'rootEntityRef' | 'explicit';
+    /** Class metadata category (must be `behaviorPool`). */
+    classCategory: string;
+}
+export interface RapGenerateValidation {
+    /** MAIN source contains a `FOR BEHAVIOR OF <bdef>` clause that points at the discovered BDEF. */
+    mainHasForBehaviorOf: boolean;
+    /** BDEF source contains `managed implementation in class <className>` (or `unmanaged …`) bound to the class. */
+    bdefBindsClass: boolean;
+    /** Free-text reason when one of the cross-references doesn't match. */
+    mismatchReason?: string;
+}
+export interface RapGenerateActivation {
+    success: boolean;
+    /** Human-friendly recovery hint when `success === false` for a known soft-failure mode. */
+    hint?: string;
+    /** Activation messages from SAP (errors + warnings + info). */
+    messages?: string[];
+}
+export interface RapGenerateResult {
+    discovery: RapGenerateDiscovery;
+    validation: RapGenerateValidation;
+    /** Whether any include source actually changed during scaffolding. */
+    scaffoldChanged: boolean;
+    /** Sections updated by the scaffold (e.g. ['definitions', 'implementations']). */
+    changedSections: Array<'main' | 'definitions' | 'implementations'>;
+    /** Counts by category for telemetry / talk demos. */
+    inserted: {
+        signatures: number;
+        stubs: number;
+        autoCreatedSkeletons: number;
+    };
+    /** Required handlers parsed out of the BDEF (post `targetAlias` filter). */
+    required: RapHandlerRequirement[];
+    /** Activation report; absent when `activate=false` or when scaffold made no changes. */
+    activation?: RapGenerateActivation;
+    /** Echoes the `dryRun` request flag for caller convenience. */
+    dryRun: boolean;
+}
+/**
+ * Classify a `generate_behavior_implementation` outcome as MCP success vs error.
+ *
+ * The orchestrator never throws on activation failure — it returns a structured
+ * result so the caller can see what was scaffolded. The handler then decides
+ * which MCP result code to surface. See Codex review on PR #260 (P1):
+ *   - activation absent (dryRun / activate=false / no scaffold change + no activation) → success
+ *   - activation.success === true → success
+ *   - activation.success === false WITH hint (e.g. stale-active CCDEF coupling) → success
+ *     (the source is correct; the user follows the recovery path)
+ *   - activation.success === false WITHOUT hint → error (real compile failure)
+ */
+export declare function isRapGenerateResultSuccess(result: RapGenerateResult): boolean;
+/**
+ * Run the high-level "Generate Behavior Implementation" flow against a
+ * behavior pool class. See module-level docs for the contract.
+ */
+export declare function generateBehaviorImplementation(client: AdtClient, className: string, options?: RapGenerateOptions): Promise<RapGenerateResult>;
+//# sourceMappingURL=rap-generate.d.ts.map

package/dist/adt/rap-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rap-generate.d.ts","sourceRoot":"","sources":["../../src/adt/rap-generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IACrC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gHAAgH;IAChH,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,sEAAsE;IACtE,eAAe,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,CAAC;IACnE,qDAAqD;IACrD,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,4EAA4E;IAC5E,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,wFAAwF;IACxF,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAI7E;AA8CD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAiN5B"}

package/dist/adt/rap-generate.js

@@ -0,0 +1,262 @@
+/**
+ * High-level RAP behavior pool generator (PR-C / SAPWrite generate_behavior_implementation).
+ *
+ * One-shot equivalent of Eclipse ADT's "Generate Behavior Implementation"
+ * Cmd+1 quickfix on a behavior pool class. Composes existing capabilities:
+ *
+ *   1. parseClassMetadata.rootEntityRef  — auto-discover the bound BDEF
+ *   2. extractRapHandlerRequirements     — derive every required handler method
+ *   3. applyRapHandlerScaffold           — auto-create lhc_<alias> skeletons,
+ *                                          inject signatures + empty stubs
+ *   4. updateSource (per include URL)    — write CCDEF + CCIMP under one lock
+ *   5. activateBatch                     — optional final activation
+ *
+ * This avoids the broken `/sap/bc/adt/quickfixes/proposals/.../create_class_implementation`
+ * server endpoint (HTTP 500 on a4h regardless of payload — verified live during research).
+ * Local generation is deterministic, fully unit-testable, and reuses the proven PR #257
+ * include-write path.
+ *
+ * Inputs:
+ *   className — the behavior pool class (e.g. "ZBP_DM_PROJECT")
+ *   options.bdefName — explicit BDEF override; default is auto-discovery from rootEntityRef
+ *   options.targetAlias — restrict scaffold to one entity alias (case-insensitive)
+ *   options.activate — also run SAPActivate after writing (default true)
+ *   options.dryRun — preview without writing/activating (default false)
+ *
+ * Output:
+ *   `RapGenerateResult` carries the discovery, validation, scaffold, and activation
+ *   outcomes. Activation failures matching the "stale active CCDEF/CCIMP placeholder
+ *   + new inactive content" coupling DO NOT throw — they return `activation.success=false`
+ *   with a guided `hint` so the caller can surface the recovery path. Other activation
+ *   failures rethrow.
+ */
+import { lockObject, unlockObject, updateSource } from './crud.js';
+import { activateBatch } from './devtools.js';
+import { AdtApiError, AdtSafetyError } from './errors.js';
+import { applyRapHandlerScaffold, extractRapHandlerRequirements, findMissingRapHandlerImplementationStubs, findMissingRapHandlerRequirements, } from './rap-handlers.js';
+/**
+ * Classify a `generate_behavior_implementation` outcome as MCP success vs error.
+ *
+ * The orchestrator never throws on activation failure — it returns a structured
+ * result so the caller can see what was scaffolded. The handler then decides
+ * which MCP result code to surface. See Codex review on PR #260 (P1):
+ *   - activation absent (dryRun / activate=false / no scaffold change + no activation) → success
+ *   - activation.success === true → success
+ *   - activation.success === false WITH hint (e.g. stale-active CCDEF coupling) → success
+ *     (the source is correct; the user follows the recovery path)
+ *   - activation.success === false WITHOUT hint → error (real compile failure)
+ */
+export function isRapGenerateResultSuccess(result) {
+    if (!result.activation)
+        return true;
+    if (result.activation.success)
+        return true;
+    return Boolean(result.activation.hint);
+}
+/**
+ * Recovery hint for the well-known "stale active CCDEF/CCIMP placeholder + new
+ * inactive handlers" activation rejection. Surfaced verbatim when SAP returns
+ * `Local classes of "CL_ABAP_BEHAVIOR_HANDLER" can only be derived in the
+ * "Local Definitions/Implementations" of a global BEHAVIOR class`. The hint is
+ * intentionally specific — generic "try Eclipse" advice would not unblock the
+ * SEGW→RAP migration skill.
+ */
+const STALE_ACTIVE_HINT = 'Activation rejected with the well-known "Local classes of CL_ABAP_BEHAVIOR_HANDLER…" error. ' +
+    'This typically means the active CCDEF/CCIMP for this class are still SAP placeholder comments ' +
+    'while the inactive copies now contain real handlers, and RAP refuses the inactive→active transition. ' +
+    'Recovery options: (a) activate the class once via Eclipse "Generate Behavior Implementation" wizard ' +
+    '(it bypasses this coupling), or (b) delete and recreate the class via SAPWrite(action="delete", type="CLAS") ' +
+    'followed by SAPWrite(action="create", type="CLAS", …) and rerun generate_behavior_implementation against ' +
+    'the freshly created class. The just-written CCDEF/CCIMP source is correct and reusable in both recovery paths.';
+/** Build the include URL for CCDEF/CCIMP/macros/testclasses (mirror of intent.ts:classIncludeUrl). */
+function classIncludeUrlFor(name, include) {
+    return `/sap/bc/adt/oo/classes/${encodeURIComponent(name)}/includes/${include}`;
+}
+function classObjectUrl(name) {
+    return `/sap/bc/adt/oo/classes/${encodeURIComponent(name)}`;
+}
+function classMainSourceUrl(name) {
+    return `${classObjectUrl(name)}/source/main`;
+}
+const FOR_BEHAVIOR_OF_RE = /\bfor\s+behavior\s+of\s+(\w+)/i;
+const MANAGED_IMPL_RE = /\b(?:managed|unmanaged|projection)\s+implementation\s+in\s+class\s+(\w+)\s+unique\b/i;
+/**
+ * "Local classes of CL_ABAP_BEHAVIOR_HANDLER…" is the activation rejection that
+ * happens when the active CCDEF/CCIMP placeholders are out of sync with the new
+ * inactive content. We recognize it by the stable English fragment SAP emits in
+ * the activation message body — the message text is identical across 7.50 and
+ * 7.58 (verified live during PR-C research, 2026-05-10).
+ */
+const STALE_ACTIVE_RE = /local classes of\s+["']?cl_abap_behavior_handler["']?\s+can\s+only\s+be\s+derived/i;
+/**
+ * Run the high-level "Generate Behavior Implementation" flow against a
+ * behavior pool class. See module-level docs for the contract.
+ */
+export async function generateBehaviorImplementation(client, className, options = {}) {
+    const dryRun = options.dryRun === true;
+    const activateRequested = options.activate !== false; // default true
+    const targetAlias = (options.targetAlias ?? '').trim().toLowerCase();
+    const transport = options.transport;
+    if (!className?.trim()) {
+        throw new AdtSafetyError('generate_behavior_implementation: className is required.');
+    }
+    const cleanClassName = className.trim();
+    // ── Phase 1: discovery ────────────────────────────────────────────────
+    const metadata = await client.getClassMetadata(cleanClassName);
+    if (metadata.category !== 'behaviorPool') {
+        throw new AdtSafetyError(`generate_behavior_implementation: class ${cleanClassName} is not a RAP behavior pool ` +
+            `(class:category=${metadata.category || '<empty>'}). The action only operates on classes ` +
+            `marked behaviorPool. Create the class via SAPWrite(action="create", type="CLAS") with a ` +
+            `'CLASS … FOR BEHAVIOR OF <bdef>' DEFINITION header and ensure the BDEF is active first.`);
+    }
+    const explicitBdef = options.bdefName?.trim();
+    let bdefName = explicitBdef ?? metadata.rootEntityRef?.name ?? '';
+    const discoverySource = explicitBdef ? 'explicit' : 'rootEntityRef';
+    if (!bdefName) {
+        throw new AdtSafetyError(`generate_behavior_implementation: cannot auto-discover BDEF for ${cleanClassName} — ` +
+            `class metadata has no rootEntityRef. Pass an explicit "bdefName" parameter to override.`);
+    }
+    bdefName = bdefName.toUpperCase();
+    // ── Phase 2: read sources + cross-validate ────────────────────────────
+    const structured = await client.getClassStructured(cleanClassName);
+    const mainSource = structured.main ?? '';
+    const definitionsSource = structured.definitions ?? '';
+    const implementationsSource = structured.implementations ?? '';
+    const bdefRead = await client.getBdef(bdefName);
+    const bdefSource = bdefRead.source;
+    const mainBdefMatch = FOR_BEHAVIOR_OF_RE.exec(mainSource);
+    const bdefClassMatch = MANAGED_IMPL_RE.exec(bdefSource);
+    const mainBdefRef = mainBdefMatch?.[1]?.toUpperCase();
+    const bdefClassRef = bdefClassMatch?.[1]?.toUpperCase();
+    const validation = {
+        mainHasForBehaviorOf: Boolean(mainBdefRef),
+        bdefBindsClass: Boolean(bdefClassRef),
+    };
+    const mismatches = [];
+    if (!mainBdefRef) {
+        mismatches.push(`MAIN source for ${cleanClassName} does not contain "FOR BEHAVIOR OF <bdef>"`);
+    }
+    else if (mainBdefRef !== bdefName) {
+        mismatches.push(`MAIN binds BDEF ${mainBdefRef} but discovery resolved to ${bdefName}`);
+    }
+    if (!bdefClassRef) {
+        mismatches.push(`BDEF ${bdefName} does not contain "managed implementation in class <class> unique"`);
+    }
+    else if (bdefClassRef !== cleanClassName.toUpperCase()) {
+        mismatches.push(`BDEF ${bdefName} binds class ${bdefClassRef} but we are generating for ${cleanClassName}`);
+    }
+    if (mismatches.length > 0) {
+        validation.mismatchReason = mismatches.join('; ');
+    }
+    if (validation.mismatchReason && !dryRun) {
+        throw new AdtSafetyError(`generate_behavior_implementation: cross-reference validation failed (${validation.mismatchReason}). ` +
+            `Refusing to mutate. Re-run with dryRun=true to inspect the report and fix the source files first.`);
+    }
+    // ── Phase 3: scaffold plan ────────────────────────────────────────────
+    let requirements = extractRapHandlerRequirements(bdefSource);
+    if (targetAlias) {
+        requirements = requirements.filter((req) => req.entityAlias.toLowerCase() === targetAlias);
+    }
+    const combinedSource = [mainSource, definitionsSource, implementationsSource].filter(Boolean).join('\n\n');
+    const missingSignatures = findMissingRapHandlerRequirements(requirements, combinedSource);
+    const missingStubs = findMissingRapHandlerImplementationStubs(requirements, combinedSource);
+    const scaffoldPlan = applyRapHandlerScaffold({
+        main: mainSource,
+        definitions: definitionsSource || undefined,
+        implementations: implementationsSource || undefined,
+    }, missingSignatures, missingStubs);
+    const result = {
+        discovery: {
+            className: cleanClassName,
+            bdefName,
+            source: discoverySource,
+            classCategory: metadata.category,
+        },
+        validation,
+        scaffoldChanged: scaffoldPlan.changedSections.length > 0,
+        changedSections: scaffoldPlan.changedSections.filter((section) => section === 'main' || section === 'definitions' || section === 'implementations'),
+        inserted: {
+            signatures: scaffoldPlan.insertedSignatureCount,
+            stubs: scaffoldPlan.insertedImplementationStubCount,
+            autoCreatedSkeletons: (scaffoldPlan.skeletons?.createdDefinitions.length ?? 0) +
+                (scaffoldPlan.skeletons?.createdImplementations.length ?? 0),
+        },
+        required: requirements,
+        dryRun,
+    };
+    // Dry-run short-circuits before any side effects.
+    if (dryRun) {
+        return result;
+    }
+    const objectUrl = classObjectUrl(cleanClassName);
+    // ── Phase 4: write (only when scaffold has changes) ───────────────────
+    // When scaffoldChanged=false, all handlers are already in place — skip the
+    // lock+write cycle entirely. Activation still runs below if requested, because
+    // a populated-but-inactive class is a realistic rerun/recovery state after
+    // earlier manual include writes (Codex review note on PR #260).
+    if (result.scaffoldChanged) {
+        await client.http.withStatefulSession(async (session) => {
+            const lock = await lockObject(session, client.safety, objectUrl, 'MODIFY');
+            const effectiveTransport = transport ?? (lock.corrNr || undefined);
+            try {
+                if (scaffoldPlan.changed.main && scaffoldPlan.sections.main !== mainSource) {
+                    await updateSource(session, client.safety, classMainSourceUrl(cleanClassName), scaffoldPlan.sections.main, lock.lockHandle, effectiveTransport);
+                }
+                if (scaffoldPlan.changed.definitions && scaffoldPlan.sections.definitions) {
+                    await updateSource(session, client.safety, classIncludeUrlFor(cleanClassName, 'definitions'), scaffoldPlan.sections.definitions, lock.lockHandle, effectiveTransport);
+                }
+                if (scaffoldPlan.changed.implementations && scaffoldPlan.sections.implementations) {
+                    await updateSource(session, client.safety, classIncludeUrlFor(cleanClassName, 'implementations'), scaffoldPlan.sections.implementations, lock.lockHandle, effectiveTransport);
+                }
+            }
+            finally {
+                try {
+                    await unlockObject(session, objectUrl, lock.lockHandle);
+                }
+                catch {
+                    // best-effort-cleanup: surface the original error, not an unlock failure
+                }
+            }
+        });
+    }
+    // ── Phase 5: optional activation ──────────────────────────────────────
+    if (activateRequested) {
+        try {
+            const activationOutcome = await activateBatch(client.http, client.safety, [
+                { url: objectUrl, name: cleanClassName },
+            ]);
+            const detailMessages = (activationOutcome.details ?? []).map((d) => d.text).filter(Boolean);
+            const allMessages = [...(activationOutcome.messages ?? []), ...detailMessages];
+            if (activationOutcome.success) {
+                result.activation = { success: true, messages: allMessages };
+            }
+            else {
+                const matchedStaleActive = allMessages.some((msg) => STALE_ACTIVE_RE.test(msg));
+                result.activation = {
+                    success: false,
+                    messages: allMessages,
+                    hint: matchedStaleActive ? STALE_ACTIVE_HINT : undefined,
+                };
+            }
+        }
+        catch (err) {
+            // The activateBatch path normally returns a result rather than throwing,
+            // but RAP-not-available / network errors / safety errors propagate. The
+            // stale-active soft-failure is detected via message inspection above.
+            // For unrecognised errors we attach the source-of-truth error message but
+            // keep the result structure so callers can still see the scaffold report.
+            if (err instanceof AdtApiError && STALE_ACTIVE_RE.test(err.message)) {
+                result.activation = {
+                    success: false,
+                    messages: [err.message],
+                    hint: STALE_ACTIVE_HINT,
+                };
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=rap-generate.js.map

package/dist/adt/rap-generate.js.map

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

package/dist/adt/rap-handlers.d.ts

@@ -60,6 +60,12 @@ export interface RapHandlerSectionApplyResults {
 }
 export interface RapHandlerScaffoldPlan {
     sections: RapHandlerSourceSections;
+    skeletons: {
+        createdDefinitions: string[];
+        createdImplementations: string[];
+        changed: Record<RapHandlerSectionName, boolean>;
+        changedSections: RapHandlerSectionName[];
+    };
     signatures: RapHandlerSectionApplyResults;
     implementationStubs: RapHandlerSectionApplyResults;
     unresolved: RapHandlerRequirement[];
@@ -68,6 +74,13 @@ export interface RapHandlerScaffoldPlan {
     insertedSignatureCount: number;
     insertedImplementationStubCount: number;
 }
+export interface RapHandlerSkeletonResult {
+    sections: RapHandlerSourceSections;
+    createdDefinitions: string[];
+    createdImplementations: string[];
+    changed: Record<RapHandlerSectionName, boolean>;
+    changedSections: RapHandlerSectionName[];
+}
 export declare function rapHandlerRequirementKey(requirement: RapHandlerRequirement): string;
 /**
  * Extract RAP behavior-pool handler method requirements from interface BDEF source.
@@ -145,6 +158,7 @@ export declare function applyRapHandlerImplementationStubs(classSource: string,
     createImplementationBlocks?: boolean;
     definitionSource?: string;
 }): RapHandlerApplyResult;
+export declare function ensureRapHandlerSkeletons(sections: RapHandlerSourceSections, requirements: RapHandlerRequirement[]): RapHandlerSkeletonResult;
 /**
  * Build the complete auto-apply plan for a behavior pool without doing I/O.
  *

package/dist/adt/rap-handlers.d.ts.map

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

package/dist/adt/rap-handlers.js

@@ -718,6 +718,82 @@ function countInserted(results) {
 function changedSectionsFrom(changed) {
     return Object.keys(changed).filter((section) => changed[section]);
 }
+function uniqueRequirementsByTargetClass(requirements) {
+    const seen = new Set();
+    const out = [];
+    for (const requirement of requirements) {
+        const key = requirement.targetHandlerClass.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(requirement);
+    }
+    return out;
+}
+function hasClassDefinition(sections, targetHandlerClass) {
+    const target = targetHandlerClass.toLowerCase();
+    return [sections.main, sections.definitions, sections.implementations]
+        .filter(Boolean)
+        .some((source) => parseClassDefinitionRanges(source ?? '').some((range) => range.name.toLowerCase() === target));
+}
+function hasClassImplementation(sections, targetHandlerClass) {
+    const target = targetHandlerClass.toLowerCase();
+    return [sections.main, sections.definitions, sections.implementations]
+        .filter(Boolean)
+        .some((source) => parseClassImplementationRanges(source ?? '').some((range) => range.name.toLowerCase() === target));
+}
+function appendBlocksToSection(source, blocks) {
+    if (blocks.length === 0)
+        return source;
+    const blockText = blocks.join('\n\n');
+    if (!source || source.trim().length === 0)
+        return `${blockText}\n`;
+    const separator = source.endsWith('\n') ? (source.endsWith('\n\n') ? '' : '\n') : '\n\n';
+    return `${source}${separator}${blockText}\n`;
+}
+function handlerDefinitionSkeleton(targetHandlerClass) {
+    return `CLASS ${targetHandlerClass} DEFINITION INHERITING FROM cl_abap_behavior_handler.
+  PRIVATE SECTION.
+ENDCLASS.`;
+}
+function handlerImplementationSkeleton(targetHandlerClass) {
+    return `CLASS ${targetHandlerClass} IMPLEMENTATION.
+ENDCLASS.`;
+}
+export function ensureRapHandlerSkeletons(sections, requirements) {
+    const targetRequirements = uniqueRequirementsByTargetClass(requirements);
+    const definitionBlocks = [];
+    const implementationBlocks = [];
+    const createdDefinitions = [];
+    const createdImplementations = [];
+    for (const requirement of targetRequirements) {
+        const targetHandlerClass = requirement.targetHandlerClass;
+        if (!hasClassDefinition(sections, targetHandlerClass)) {
+            definitionBlocks.push(handlerDefinitionSkeleton(targetHandlerClass));
+            createdDefinitions.push(targetHandlerClass);
+        }
+        if (!hasClassImplementation(sections, targetHandlerClass)) {
+            implementationBlocks.push(handlerImplementationSkeleton(targetHandlerClass));
+            createdImplementations.push(targetHandlerClass);
+        }
+    }
+    const changed = {
+        main: false,
+        definitions: createdDefinitions.length > 0,
+        implementations: createdImplementations.length > 0,
+    };
+    return {
+        sections: {
+            main: sections.main,
+            definitions: appendBlocksToSection(sections.definitions, definitionBlocks),
+            implementations: appendBlocksToSection(sections.implementations, implementationBlocks),
+        },
+        createdDefinitions,
+        createdImplementations,
+        changed,
+        changedSections: changedSectionsFrom(changed),
+    };
+}
 /**
  * Build the source used to resolve semantic method names while creating stubs.
  *
@@ -783,30 +859,35 @@ function applySignaturesAcrossSections(sections, missingSignatures) {
  * names come from declarations, not necessarily from BDEF action names".
  */
 export function applyRapHandlerScaffold(sections, missingSignatures, missingImplementationStubs) {
-    const signaturePlan = applySignaturesAcrossSections(sections, missingSignatures);
+    const skeletonPlan = ensureRapHandlerSkeletons(sections, [...missingSignatures, ...missingImplementationStubs]);
+    const signaturePlan = applySignaturesAcrossSections(skeletonPlan.sections, missingSignatures);
     // A METHOD stub is only useful after its declaration exists. If the target
     // `lhc_*` class was not found anywhere, suppress the stub for that unresolved
     // declaration rather than creating an implementation block with no matching
     // RAP handler signature.
     const unresolvedDeclarationKeys = new Set(signaturePlan.unresolved.map(rapHandlerRequirementKey));
     const stubRequirements = missingImplementationStubs.filter((req) => !unresolvedDeclarationKeys.has(rapHandlerRequirementKey(req)));
-    const definitionLookupSource = buildDefinitionLookupSource(sections, signaturePlan);
+    const definitionLookupSource = buildDefinitionLookupSource(skeletonPlan.sections, signaturePlan);
     const stubMain = applyRapHandlerImplementationStubs(signaturePlan.updatedSections.main, stubRequirements, {
         createImplementationBlocks: true,
         definitionSource: definitionLookupSource,
     });
-    const stubDefinitions = sections.definitions
-        ? applyRapHandlerImplementationStubs(signaturePlan.updatedSections.definitions ?? sections.definitions, stubRequirements, {
+    const stubDefinitions = skeletonPlan.sections.definitions
+        ? applyRapHandlerImplementationStubs(signaturePlan.updatedSections.definitions ?? skeletonPlan.sections.definitions, stubRequirements, {
             definitionSource: definitionLookupSource,
         })
         : undefined;
-    const stubImplementations = sections.implementations
-        ? applyRapHandlerImplementationStubs(signaturePlan.updatedSections.implementations ?? sections.implementations, stubRequirements, { createImplementationBlocks: true, definitionSource: definitionLookupSource })
+    const stubImplementations = skeletonPlan.sections.implementations
+        ? applyRapHandlerImplementationStubs(signaturePlan.updatedSections.implementations ?? skeletonPlan.sections.implementations, stubRequirements, { createImplementationBlocks: true, definitionSource: definitionLookupSource })
         : undefined;
     const changed = {
-        main: signaturePlan.signatures.main.changed || stubMain.changed,
-        definitions: (signaturePlan.signatures.definitions?.changed ?? false) || (stubDefinitions?.changed ?? false),
-        implementations: (signaturePlan.signatures.implementations?.changed ?? false) || (stubImplementations?.changed ?? false),
+        main: skeletonPlan.changed.main || signaturePlan.signatures.main.changed || stubMain.changed,
+        definitions: skeletonPlan.changed.definitions ||
+            (signaturePlan.signatures.definitions?.changed ?? false) ||
+            (stubDefinitions?.changed ?? false),
+        implementations: skeletonPlan.changed.implementations ||
+            (signaturePlan.signatures.implementations?.changed ?? false) ||
+            (stubImplementations?.changed ?? false),
     };
     const changedSections = changedSectionsFrom(changed);
     return {
@@ -815,6 +896,12 @@ export function applyRapHandlerScaffold(sections, missingSignatures, missingImpl
             definitions: stubDefinitions?.updatedSource ?? signaturePlan.updatedSections.definitions,
             implementations: stubImplementations?.updatedSource ?? signaturePlan.updatedSections.implementations,
         },
+        skeletons: {
+            createdDefinitions: skeletonPlan.createdDefinitions,
+            createdImplementations: skeletonPlan.createdImplementations,
+            changed: skeletonPlan.changed,
+            changedSections: skeletonPlan.changedSections,
+        },
         signatures: signaturePlan.signatures,
         implementationStubs: {
             main: stubMain,