@memberjunction/core-actions 5.37.0 → 5.38.0

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { buildDefaultFormScaffold } from "@memberjunction/interactive-component-types/forms";
+/**
+ * Read-only action that produces a working form-role `ComponentSpec`
+ * scaffolded from the entity's CodeGen metadata (Category /
+ * GeneratedFormSectionType / Sequence / FK relationships / value lists).
+ *
+ * **Why this exists.** Today the Form Builder agent writes JSX from
+ * scratch every time, producing inconsistent quality. Calling this action
+ * first gives the agent a known-good baseline (mirrors the default Angular
+ * form) that it can modify per user requirements instead of inventing a
+ * layout. Far fewer lint failures, dramatically better starting point.
+ *
+ * **Pure read.** No persistence. The returned spec is intended to be
+ * modified and then passed to {@link CreateInteractiveFormAction} or
+ * {@link ModifyInteractiveFormAction}.
+ */
+let GetDefaultFormScaffoldForEntityAction = class GetDefaultFormScaffoldForEntityAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Spec` parameter — the scaffolded `ComponentSpec` object (componentRole='form', location='embedded').
+     *   - `Message` — the same object, stringified.
+     */
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getStringParam(params, "EntityName");
+            if (!entityName) {
+                return failure("MISSING_PARAMETER", "Parameter 'EntityName' is required.");
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            }
+            const spec = buildDefaultFormScaffold(entityName, provider);
+            if (!spec) {
+                return failure("ENTITY_NOT_FOUND", `Entity '${entityName}' is not registered with the active metadata provider.`);
+            }
+            params.Params.push({
+                Name: "Spec",
+                Type: "Output",
+                Value: spec,
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(spec),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetDefaultFormScaffoldForEntityAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    getStringParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        if (!p || p.Value == null)
+            return null;
+        const v = String(p.Value).trim();
+        return v.length > 0 ? v : null;
+    }
+};
+GetDefaultFormScaffoldForEntityAction = __decorate([
+    RegisterClass(BaseAction, "__GetDefaultFormScaffoldForEntity")
+], GetDefaultFormScaffoldForEntityAction);
+export { GetDefaultFormScaffoldForEntityAction };
+function failure(resultCode, message) {
+    return { Success: false, ResultCode: resultCode, Message: message };
+}
+/** Tree-shaking guard — called from src/index.ts. */
+export function LoadGetDefaultFormScaffoldForEntityAction() {
+    if (false) {
+        const _ = GetDefaultFormScaffoldForEntityAction;
+    }
+}
+//# sourceMappingURL=get-default-form-scaffold.action.js.map

package/dist/custom/interactive-forms/get-default-form-scaffold.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-default-form-scaffold.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-default-form-scaffold.action.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAE7F;;;;;;;;;;;;;;GAcG;AAEI,IAAM,qCAAqC,GAA3C,MAAM,qCAAsC,SAAQ,UAAU;IAEjE;;;;;;;OAOG;IACO,KAAK,CAAC,iBAAiB,CAAC,MAAuB;QACrD,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;gBACd,OAAO,OAAO,CAAC,mBAAmB,EAAE,qCAAqC,CAAC,CAAC;YAC/E,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;YACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,OAAO,OAAO,CAAC,aAAa,EAAE,iCAAiC,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,IAAI,GAAG,wBAAwB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO,OAAO,CACV,kBAAkB,EAClB,WAAW,UAAU,wDAAwD,CAChF,CAAC;YACN,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAChC,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,0CAA0C,OAAO,EAAE,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,MAAuB,EAAE,IAAY;QACxD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAC7B,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;CACJ,CAAA;AAvDY,qCAAqC;IADjD,aAAa,CAAC,UAAU,EAAE,mCAAmC,CAAC;GAClD,qCAAqC,CAuDjD;;AAED,SAAS,OAAO,CAAC,UAAkB,EAAE,OAAe;IAChD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACxE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,yCAAyC;IACrD,IAAI,KAAgB,EAAE,CAAC;QACnB,MAAM,CAAC,GAAY,qCAAqC,CAAC;IAC7D,CAAC;AACL,CAAC"}

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts

@@ -0,0 +1,34 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Read-only action consumed by the Form Builder agent to inspect an entity's
+ * curated form-relevant schema before generating a form Component.
+ *
+ * Returns the `CuratedFormSchema` shape: FK references resolved to
+ * `{entity, displayField}`, value-list fields annotated with `allowedValues`,
+ * and audit / virtual / computed fields stripped. See
+ * `@memberjunction/interactive-component-types/forms` for the type.
+ *
+ * Output is stringified JSON in `Message` (Action framework convention) and
+ * also surfaced as a `Schema` output parameter for callers that prefer
+ * structured access.
+ */
+export declare class GetEntitySchemaForFormAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Schema` parameter — the `CuratedFormSchema` object.
+     *   - `Message` — the same object, stringified.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /** Case-insensitive trim-tolerant fetch for the EntityName param. */
+    private getEntityNameParam;
+}
+/**
+ * Tree-shaking guard. Imported and called from src/index.ts so bundlers
+ * don't drop the action when no consumer references it by name.
+ */
+export declare function LoadGetEntitySchemaForFormAction(): void;
+//# sourceMappingURL=get-entity-schema-for-form.action.d.ts.map

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema-for-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-entity-schema-for-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;GAYG;AACH,qBACa,4BAA6B,SAAQ,UAAU;IAExD;;;;;;;OAOG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmDvF,qEAAqE;IACrE,OAAO,CAAC,kBAAkB;CAS7B;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.js

@@ -0,0 +1,103 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { buildCuratedFormSchema } from "@memberjunction/interactive-component-types/forms";
+/**
+ * Read-only action consumed by the Form Builder agent to inspect an entity's
+ * curated form-relevant schema before generating a form Component.
+ *
+ * Returns the `CuratedFormSchema` shape: FK references resolved to
+ * `{entity, displayField}`, value-list fields annotated with `allowedValues`,
+ * and audit / virtual / computed fields stripped. See
+ * `@memberjunction/interactive-component-types/forms` for the type.
+ *
+ * Output is stringified JSON in `Message` (Action framework convention) and
+ * also surfaced as a `Schema` output parameter for callers that prefer
+ * structured access.
+ */
+let GetEntitySchemaForFormAction = class GetEntitySchemaForFormAction extends BaseAction {
+    /**
+     * Required input:
+     *   - `EntityName` (string) — fully-qualified entity name, e.g. "MJ: Applications".
+     *
+     * Output:
+     *   - `Schema` parameter — the `CuratedFormSchema` object.
+     *   - `Message` — the same object, stringified.
+     */
+    async InternalRunAction(params) {
+        try {
+            const entityName = this.getEntityNameParam(params);
+            if (!entityName) {
+                return {
+                    Success: false,
+                    ResultCode: "MISSING_PARAMETER",
+                    Message: "Parameter 'EntityName' is required.",
+                };
+            }
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider) {
+                return {
+                    Success: false,
+                    ResultCode: "NO_PROVIDER",
+                    Message: "No metadata provider available. Action requires a configured provider on the run params or globally.",
+                };
+            }
+            const schema = buildCuratedFormSchema(entityName, provider);
+            if (!schema) {
+                return {
+                    Success: false,
+                    ResultCode: "ENTITY_NOT_FOUND",
+                    Message: `Entity '${entityName}' is not registered with the active metadata provider.`,
+                };
+            }
+            params.Params.push({
+                Name: "Schema",
+                Type: "Output",
+                Value: schema,
+            });
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: JSON.stringify(schema),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`GetEntitySchemaForFormAction: ${message}`);
+            return {
+                Success: false,
+                ResultCode: "UNEXPECTED_ERROR",
+                Message: message,
+            };
+        }
+    }
+    /** Case-insensitive trim-tolerant fetch for the EntityName param. */
+    getEntityNameParam(params) {
+        const param = params.Params.find(p => p.Name?.trim().toLowerCase() === "entityname");
+        if (!param || param.Value == null) {
+            return null;
+        }
+        const value = String(param.Value).trim();
+        return value.length > 0 ? value : null;
+    }
+};
+GetEntitySchemaForFormAction = __decorate([
+    RegisterClass(BaseAction, "__GetEntitySchemaForForm")
+], GetEntitySchemaForFormAction);
+export { GetEntitySchemaForFormAction };
+/**
+ * Tree-shaking guard. Imported and called from src/index.ts so bundlers
+ * don't drop the action when no consumer references it by name.
+ */
+export function LoadGetEntitySchemaForFormAction() {
+    if (false) {
+        const _ = GetEntitySchemaForFormAction;
+    }
+}
+//# sourceMappingURL=get-entity-schema-for-form.action.js.map

package/dist/custom/interactive-forms/get-entity-schema-for-form.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema-for-form.action.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/get-entity-schema-for-form.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/interactive-forms/index.d.ts

@@ -0,0 +1,8 @@
+export * from './get-entity-schema-for-form.action.js';
+export * from './get-default-form-scaffold.action.js';
+export * from './get-active-form-for-entity.action.js';
+export * from './create-interactive-form.action.js';
+export * from './modify-interactive-form.action.js';
+export * from './activate-interactive-form-version.action.js';
+export * from './revert-interactive-form.action.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/custom/interactive-forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC"}

package/dist/custom/interactive-forms/index.js

@@ -0,0 +1,8 @@
+export * from './get-entity-schema-for-form.action.js';
+export * from './get-default-form-scaffold.action.js';
+export * from './get-active-form-for-entity.action.js';
+export * from './create-interactive-form.action.js';
+export * from './modify-interactive-form.action.js';
+export * from './activate-interactive-form-version.action.js';
+export * from './revert-interactive-form.action.js';
+//# sourceMappingURL=index.js.map

package/dist/custom/interactive-forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/custom/interactive-forms/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC"}

package/dist/custom/interactive-forms/modify-interactive-form.action.d.ts

@@ -0,0 +1,54 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Modify an existing interactive-form override.
+ *
+ * Behavior is driven by the **`VersionBumpKind` input** and the **source
+ * Override's status** (Override is the canonical "is this live" signal —
+ * Component.Status can drift independently):
+ *
+ * | Source Status | VersionBumpKind        | Behavior                                                                                                                                            |
+ * |---------------|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+ * | Pending       | `in-place` (default)   | Overwrite the existing Pending Component row in place. No new version. Iteration-loop behavior.                                                     |
+ * | Pending       | `patch` / `minor` / `major` | **Demote** the existing Pending → Inactive, then insert a new Pending Component v(bumped) + new Pending Override pointing at it. Creates rollback. |
+ * | Active        | `in-place`             | **Rejected** — would corrupt the live Active row. Returns `INVALID_BUMP_FOR_STATUS`.                                                                |
+ * | Active        | `patch` / `minor` (default) / `major` | Insert new Pending Component v(bumped) + new Pending Override. Active is untouched — user explicitly Activates later.                  |
+ * | Inactive      | `in-place`             | **Rejected** — overwriting a dead row achieves nothing. Use 'Revert Interactive Form' to re-activate first, or supply a bump kind.                  |
+ * | Inactive      | `patch` (default) / `minor` / `major` | Branch-from-historical. Insert new Pending Component v(bumped) sourced from this Inactive spec. The Inactive source is left alone (already historical). |
+ *
+ * **Defaults** preserve historical behavior: omit `VersionBumpKind` and
+ * Pending sources stay in-place, Active sources bump minor, Inactive
+ * sources bump patch (the conservative branch-from-historical case).
+ *
+ * **Security clamp.** Modify *always* writes a User-scope Pending Override,
+ * regardless of the original override's scope. Even if the caller is
+ * modifying a Role-scope or Global override (which they have permission to
+ * read because they pass the ownership check), the new Pending sibling
+ * is always User-scoped to the calling user. Scope promotion (User → Role
+ * → Global) is a separate, deliberate human action with its own permission
+ * gate in Component Studio / Form Builder. The agent cannot widen scope
+ * through Modify any more than through Create.
+ *
+ * **Ownership check.** The caller must own (or have role membership for, or
+ * be admin over) the existing override they're modifying. See
+ * `checkOverrideOwnership` in `_shared.ts`. Returns FORBIDDEN if rejected.
+ *
+ * Inputs:
+ *   - `OverrideID` (required, string) — the override to modify
+ *   - `Spec` (required, ComponentSpec | string) — the new form spec
+ *   - `Notes` (optional, string) — appended to the override's Notes column
+ *   - `VersionBumpKind` (optional, 'in-place' | 'patch' | 'minor' | 'major') — see table above
+ *
+ * Outputs:
+ *   - `ComponentID` — the Component row that now holds the spec (new for snapshots, same for in-place)
+ *   - `OverrideID` — the Override row that points at it
+ *   - `Mode` — 'in-place' or 'new-version'
+ *   - `Version` — the Component's resulting Version string
+ */
+export declare class ModifyInteractiveFormAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private findParam;
+}
+/** Tree-shaking guard. */
+export declare function LoadModifyInteractiveFormAction(): void;
+//# sourceMappingURL=modify-interactive-form.action.d.ts.map

package/dist/custom/interactive-forms/modify-interactive-form.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify-interactive-form.action.d.ts","sourceRoot":"","sources":["../../../src/custom/interactive-forms/modify-interactive-form.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBACa,2BAA4B,SAAQ,UAAU;cAEvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuOvF,OAAO,CAAC,SAAS;CAKpB;AAED,0BAA0B;AAC1B,wBAAgB,+BAA+B,IAAI,IAAI,CAItD"}

package/dist/custom/interactive-forms/modify-interactive-form.action.js

@@ -0,0 +1,300 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseAction } from "@memberjunction/actions";
+import { Metadata, LogError } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+import { addOutput, bumpVersion, checkOverrideOwnership, failure, getStringParam, insertComponent, insertOverride, lintFormSpec, loadComponent, loadOverride, mapToComponentStatus, parseSpecParam, parseVersionBumpKind, } from "./_shared.js";
+/**
+ * Modify an existing interactive-form override.
+ *
+ * Behavior is driven by the **`VersionBumpKind` input** and the **source
+ * Override's status** (Override is the canonical "is this live" signal —
+ * Component.Status can drift independently):
+ *
+ * | Source Status | VersionBumpKind        | Behavior                                                                                                                                            |
+ * |---------------|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
+ * | Pending       | `in-place` (default)   | Overwrite the existing Pending Component row in place. No new version. Iteration-loop behavior.                                                     |
+ * | Pending       | `patch` / `minor` / `major` | **Demote** the existing Pending → Inactive, then insert a new Pending Component v(bumped) + new Pending Override pointing at it. Creates rollback. |
+ * | Active        | `in-place`             | **Rejected** — would corrupt the live Active row. Returns `INVALID_BUMP_FOR_STATUS`.                                                                |
+ * | Active        | `patch` / `minor` (default) / `major` | Insert new Pending Component v(bumped) + new Pending Override. Active is untouched — user explicitly Activates later.                  |
+ * | Inactive      | `in-place`             | **Rejected** — overwriting a dead row achieves nothing. Use 'Revert Interactive Form' to re-activate first, or supply a bump kind.                  |
+ * | Inactive      | `patch` (default) / `minor` / `major` | Branch-from-historical. Insert new Pending Component v(bumped) sourced from this Inactive spec. The Inactive source is left alone (already historical). |
+ *
+ * **Defaults** preserve historical behavior: omit `VersionBumpKind` and
+ * Pending sources stay in-place, Active sources bump minor, Inactive
+ * sources bump patch (the conservative branch-from-historical case).
+ *
+ * **Security clamp.** Modify *always* writes a User-scope Pending Override,
+ * regardless of the original override's scope. Even if the caller is
+ * modifying a Role-scope or Global override (which they have permission to
+ * read because they pass the ownership check), the new Pending sibling
+ * is always User-scoped to the calling user. Scope promotion (User → Role
+ * → Global) is a separate, deliberate human action with its own permission
+ * gate in Component Studio / Form Builder. The agent cannot widen scope
+ * through Modify any more than through Create.
+ *
+ * **Ownership check.** The caller must own (or have role membership for, or
+ * be admin over) the existing override they're modifying. See
+ * `checkOverrideOwnership` in `_shared.ts`. Returns FORBIDDEN if rejected.
+ *
+ * Inputs:
+ *   - `OverrideID` (required, string) — the override to modify
+ *   - `Spec` (required, ComponentSpec | string) — the new form spec
+ *   - `Notes` (optional, string) — appended to the override's Notes column
+ *   - `VersionBumpKind` (optional, 'in-place' | 'patch' | 'minor' | 'major') — see table above
+ *
+ * Outputs:
+ *   - `ComponentID` — the Component row that now holds the spec (new for snapshots, same for in-place)
+ *   - `OverrideID` — the Override row that points at it
+ *   - `Mode` — 'in-place' or 'new-version'
+ *   - `Version` — the Component's resulting Version string
+ */
+let ModifyInteractiveFormAction = class ModifyInteractiveFormAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            const overrideID = getStringParam(params, "OverrideID");
+            if (!overrideID) {
+                return failure("MISSING_PARAMETER", "Parameter 'OverrideID' is required.");
+            }
+            const specRaw = this.findParam(params, "Spec");
+            if (specRaw == null) {
+                return failure("MISSING_PARAMETER", "Parameter 'Spec' is required.");
+            }
+            const parsed = parseSpecParam(specRaw);
+            if ('error' in parsed) {
+                return failure("LINT_FAILED", `Spec is not valid JSON: ${parsed.error}`);
+            }
+            const spec = parsed;
+            const notes = getStringParam(params, "Notes");
+            const provider = params.Provider ?? Metadata.Provider;
+            if (!provider)
+                return failure("NO_PROVIDER", "No metadata provider available.");
+            const user = params.ContextUser;
+            if (!user)
+                return failure("NO_USER", "Action requires a ContextUser.");
+            const override = await loadOverride(provider, user, overrideID);
+            if (!override) {
+                return failure("OVERRIDE_NOT_FOUND", `EntityFormOverride '${overrideID}' not found.`);
+            }
+            // Defense-in-depth ownership check — see _shared.ts.
+            const ownershipFail = checkOverrideOwnership(override, user);
+            if (ownershipFail)
+                return ownershipFail;
+            const existingComponent = await loadComponent(provider, user, override.ComponentID);
+            if (!existingComponent) {
+                return failure("COMPONENT_NOT_FOUND", `Override ${overrideID} points at Component ${override.ComponentID} which no longer exists.`);
+            }
+            // Lineage identity guard. Component lineage is collapsed by Name
+            // in the Form Builder version rail — different Name = different
+            // lineage, no rollback link between them. The agent must NOT
+            // rename across Modify calls (e.g. sanitizing "Contemporary AI
+            // Models Form" → "ContemporaryAIModelsForm" to satisfy
+            // component-name-mismatch lint silently forks the user's form
+            // into a phantom new lineage). Reject mismatches with a clear
+            // error so the agent retries with the right name. The function
+            // name inside spec.code MUST match spec.name (enforced by
+            // component-name-mismatch lint) — keep spec.name pinned to the
+            // existing Component.Name and sanitize the function name to
+            // match, never the other way around.
+            if (spec.name && spec.name !== existingComponent.Name) {
+                return failure("LINEAGE_NAME_MISMATCH", `Modify requires spec.name to match the existing Component name '${existingComponent.Name}', got '${spec.name}'. Modify operates on a Component lineage — its identity is the Name and cannot change between versions. Update spec.name and the function declaration in spec.code to '${existingComponent.Name}' and retry. (If the user wants a renamed form, that's a Create on the new entity or a manual rename in Form Builder, not a Modify.)`);
+            }
+            // Pin Name and Title to the existing row regardless — covers
+            // the case where the agent omitted spec.name entirely.
+            spec.name = existingComponent.Name;
+            if (existingComponent.Title && !spec.title)
+                spec.title = existingComponent.Title;
+            // Lint AFTER the lineage guard so any name/title pinning is
+            // visible to the linter (function-name match, etc.).
+            const lintFail = await lintFormSpec(spec, user);
+            if (lintFail)
+                return lintFail;
+            // Resolve VersionBumpKind: explicit param wins; otherwise default
+            // by source status to preserve historical behavior — Pending →
+            // in-place (iteration loop), Active → minor (snapshot).
+            //
+            // Route off the OVERRIDE's status, not the Component's. The Override
+            // is what determines whether a form is live; Component.Status can
+            // drift independently (manual edits, partial activations) and using
+            // it for routing risks demoting an Active override on the assumption
+            // it's a Pending iteration.
+            const overrideStatus = override.Status ?? 'Pending';
+            const sourceStatus = overrideStatus === 'Active' ? 'Active' :
+                overrideStatus === 'Pending' ? 'Pending' : 'Inactive';
+            const isPendingSource = sourceStatus === 'Pending';
+            const rawKind = getStringParam(params, "VersionBumpKind");
+            let bumpKind;
+            if (rawKind) {
+                const parsed = parseVersionBumpKind(rawKind);
+                if (!parsed) {
+                    return failure("INVALID_BUMP_KIND", `Unknown VersionBumpKind '${rawKind}'. Expected one of: 'in-place', 'patch', 'minor', 'major'.`);
+                }
+                bumpKind = parsed;
+            }
+            else {
+                // Default behavior by source status. Inactive defaults to
+                // 'patch' (the conservative branch-from-historical case);
+                // any explicit kind still wins above.
+                bumpKind = isPendingSource ? 'in-place' : (sourceStatus === 'Inactive' ? 'patch' : 'minor');
+            }
+            // 'in-place' is only meaningful against a Pending source — it
+            // overwrites the iteration's Spec on the same row. Against
+            // Active (would clobber live) or Inactive (overwriting a dead
+            // row achieves nothing — won't re-activate it; use Revert for
+            // that) we reject loudly so the caller corrects intent.
+            if (bumpKind === 'in-place' && !isPendingSource) {
+                return failure("INVALID_BUMP_FOR_STATUS", `'in-place' is only valid against a Pending Override (got Status='${overrideStatus}'). Use 'patch', 'minor', or 'major' to snapshot a new Pending version from this source; use 'Revert Interactive Form' to re-activate an Inactive historical version.`);
+            }
+            if (bumpKind === 'in-place') {
+                // ── in-place modify of the Pending Component ─────────────
+                existingComponent.Specification = JSON.stringify(spec);
+                // Refresh Title/Description if the new spec moves them.
+                if (spec.title)
+                    existingComponent.Title = spec.title;
+                if (spec.description)
+                    existingComponent.Description = spec.description;
+                const saved = await existingComponent.Save();
+                if (!saved) {
+                    return failure("PERSIST_FAILED", `Component in-place update failed: ${existingComponent.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+                if (notes) {
+                    // Append a line of human-readable notes. The Notes column
+                    // accepts NVARCHAR(MAX), so this scales.
+                    const existingNotes = override.Notes ?? '';
+                    override.Notes = existingNotes
+                        ? `${existingNotes}\n${notes}`
+                        : notes;
+                    await override.Save();
+                }
+                addOutput(params, "ComponentID", existingComponent.ID);
+                addOutput(params, "OverrideID", override.ID);
+                addOutput(params, "Mode", "in-place");
+                addOutput(params, "Version", existingComponent.Version);
+                return {
+                    Success: true, ResultCode: "SUCCESS",
+                    Message: JSON.stringify({
+                        Mode: 'in-place',
+                        ComponentID: existingComponent.ID,
+                        OverrideID: override.ID,
+                        Version: existingComponent.Version,
+                    }),
+                };
+            }
+            // ── new-version path: snapshot to a new Pending Component +
+            // sibling Override. Works for Active sources (preserves the
+            // live Active row), Pending sources (where we demote the existing
+            // Pending → Inactive to keep the rollback history without producing
+            // two concurrent Pendings), and Inactive sources (branch-from-
+            // historical — no demote needed since source is already Inactive,
+            // and the user explicitly opened it to fork from there).
+            const newVersion = bumpVersion(existingComponent.Version, bumpKind);
+            const newSequence = (existingComponent.VersionSequence ?? 0) + 1;
+            const componentInsert = await insertComponent({
+                provider, user, spec,
+                fallbackName: existingComponent.Name,
+                description: existingComponent.Description,
+                version: newVersion,
+                versionSequence: newSequence,
+                componentStatus: 'Pending',
+            });
+            if ('error' in componentInsert)
+                return componentInsert.error;
+            const newComponentID = componentInsert.id;
+            // New Pending Override at the same scope as the existing one. We
+            // do not widen scope: if existing is User-scoped, new is too. If
+            // somehow existing is Role/Global (manual promotion), we still
+            // honor that — Modify is a content change, not a scope change.
+            const overrideInsert = await insertOverride({
+                provider, user,
+                entityID: override.EntityID,
+                componentID: newComponentID,
+                name: override.Name,
+                description: override.Description,
+                notes,
+                status: 'Pending',
+                priority: override.Priority,
+            });
+            if ('error' in overrideInsert) {
+                return failure("PERSIST_FAILED", `${overrideInsert.error.Message} (Component ${newComponentID} was persisted; its sibling override row failed to write.)`);
+            }
+            // Demote the prior Pending source — both the Component row and
+            // its Override row — to Inactive. This preserves the rollback
+            // history (the row stays in the version rail and can be
+            // re-Activated later) without leaving two concurrent Pendings
+            // for the same lineage. Failures here are non-fatal: the new
+            // version is already persisted, so we log and continue rather
+            // than tearing down what we just wrote.
+            let demotedComponentID = null;
+            let demotedOverrideID = null;
+            if (isPendingSource) {
+                // Component table uses 'Draft'/'Published'/'Deprecated' —
+                // map our 'Inactive' lifecycle to the table's 'Deprecated'.
+                try {
+                    existingComponent.Status = mapToComponentStatus('Inactive');
+                    const ok = await existingComponent.Save();
+                    if (ok)
+                        demotedComponentID = existingComponent.ID;
+                    else
+                        LogError(`ModifyInteractiveFormAction: failed to demote prior Pending Component ${existingComponent.ID}: ${existingComponent.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+                catch (err) {
+                    LogError(`ModifyInteractiveFormAction: error demoting prior Pending Component ${existingComponent.ID}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    override.Status = 'Inactive';
+                    const ok = await override.Save();
+                    if (ok)
+                        demotedOverrideID = override.ID;
+                    else
+                        LogError(`ModifyInteractiveFormAction: failed to demote prior Pending Override ${override.ID}: ${override.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+                catch (err) {
+                    LogError(`ModifyInteractiveFormAction: error demoting prior Pending Override ${override.ID}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            addOutput(params, "ComponentID", newComponentID);
+            addOutput(params, "OverrideID", overrideInsert.id);
+            addOutput(params, "Mode", "new-version");
+            addOutput(params, "Version", newVersion);
+            return {
+                Success: true, ResultCode: "SUCCESS",
+                Message: JSON.stringify({
+                    Mode: 'new-version',
+                    ComponentID: newComponentID,
+                    OverrideID: overrideInsert.id,
+                    Version: newVersion,
+                    BumpKind: bumpKind,
+                    PreviousComponentID: existingComponent.ID,
+                    PreviousOverrideID: override.ID,
+                    PreviousSourceStatus: sourceStatus,
+                    DemotedComponentID: demotedComponentID,
+                    DemotedOverrideID: demotedOverrideID,
+                }),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            LogError(`ModifyInteractiveFormAction: ${message}`);
+            return failure("UNEXPECTED_ERROR", message);
+        }
+    }
+    findParam(params, name) {
+        const p = params.Params.find(x => x.Name?.trim().toLowerCase() === name.toLowerCase());
+        return p?.Value;
+    }
+};
+ModifyInteractiveFormAction = __decorate([
+    RegisterClass(BaseAction, "__ModifyInteractiveForm")
+], ModifyInteractiveFormAction);
+export { ModifyInteractiveFormAction };
+/** Tree-shaking guard. */
+export function LoadModifyInteractiveFormAction() {
+    if (false) {
+        const _ = ModifyInteractiveFormAction;
+    }
+}
+//# sourceMappingURL=modify-interactive-form.action.js.map