@memberjunction/core-entities-server 6.2.0-edge.6 → 6.2.0-edge.8

package/dist/custom/RestrictedFieldCommentClassifier.js

@@ -0,0 +1,240 @@
+import { LogError, LogStatus, RunView, WellKnownUserSource } from '@memberjunction/core';
+import { AIPromptParams } from '@memberjunction/ai-core-plus';
+import { AIPromptRunner } from '@memberjunction/ai-prompts';
+import { AIEngine } from '@memberjunction/aiengine';
+import { BuildLinkedRecordPrimaryKeyFilter, DetectReferencedRestrictedFieldsDeterministic, MergeRestrictedFieldsIntoAnchorMetadata, ParseConversationAnchorMetadata } from '@memberjunction/core-entities';
+let customRestrictedFieldClassifier = null;
+/**
+ * Registers (or clears with `null`) a custom semantic classifier callback for detecting
+ * references to FLS-restricted fields in record comments. Used by tests and custom
+ * enterprise classification policies; when `null`, the default `AIEngine` classifier runs.
+ */
+export function RegisterRestrictedFieldLLMClassifier(callback) {
+    customRestrictedFieldClassifier = callback;
+}
+/**
+ * Returns the currently registered custom classifier callback, if any.
+ */
+export function GetRegisteredRestrictedFieldLLMClassifier() {
+    return customRestrictedFieldClassifier;
+}
+/**
+ * Inspects a comment (`messageText`) posted on an anchored conversation to detect whether it
+ * references any FLS-governed fields on `entityInfo`, and stamps any newly detected field names
+ * into `conversation.AnchorMetadataObject.restrictedFields`.
+ *
+ * Two-stage detection:
+ * 1. **Stage 1 (Deterministic, 0ms)**: Checks direct field anchors (`AnchorType === 'Field'`),
+ *    restricted field names/labels (`Name`, camelCase words, `DisplayName`), and actual restricted
+ *    field values loaded from the linked record.
+ * 2. **Stage 2 (Semantic LLM Classifier)**: If `entityInfo` has remaining unmatched FLS fields and
+ *    `messageText` is non-empty, invokes either the registered `RestrictedFieldLLMClassifierCallback`
+ *    or a lightweight `AIEngine` language model to detect semantic/paraphrased references
+ *    (for example `"making six figures"` → `Salary`).
+ */
+export async function InspectAndStampRestrictedFieldsForComment(params) {
+    const { Provider, ContextUser, Conversation, EntityInfo: entityInfo, MessageText } = params;
+    // fls-guard: inspect and stamp restrictedFields on anchored conversation comments
+    if (!entityInfo.FieldLevelSecurityApplies) {
+        return {
+            Allowed: true,
+            Reason: null,
+            DetectedFields: [],
+            AuthorDeniedFields: []
+        };
+    }
+    const restrictedFields = entityInfo.Fields.filter((f) => f.HasFieldPermissions);
+    if (restrictedFields.length === 0) {
+        return {
+            Allowed: true,
+            Reason: null,
+            DetectedFields: [],
+            AuthorDeniedFields: []
+        };
+    }
+    // Security invariant: never value-match against fields the authoring user is denied Read access to.
+    // An author who cannot read a field cannot be disclosing its value from the record, and matching their
+    // comment text against hidden system-loaded values would create a yes/no guessing oracle.
+    // Only fields the author CAN read are eligible for record-value matching (to stamp restrictedFields
+    // so downstream readers who lack access to that field do not see the thread).
+    const deniedLower = entityInfo.GetDeniedReadFields(ContextUser);
+    const authorReadableRestrictedFields = restrictedFields.filter((f) => !deniedLower.has(f.Name.trim().toLowerCase()));
+    let readableRecordValues = null;
+    if (authorReadableRestrictedFields.length > 0 && (MessageText ?? '').trim().length > 0) {
+        const rawRecordValues = params.RecordValues ??
+            (Conversation.LinkedRecordID
+                ? await loadLinkedRecordRestrictedFieldValues(Provider, ContextUser, entityInfo, Conversation.LinkedRecordID, authorReadableRestrictedFields)
+                : null);
+        if (rawRecordValues) {
+            readableRecordValues = {};
+            for (const f of authorReadableRestrictedFields) {
+                if (Object.prototype.hasOwnProperty.call(rawRecordValues, f.Name)) {
+                    readableRecordValues[f.Name] = rawRecordValues[f.Name];
+                }
+            }
+        }
+    }
+    // Stage 1: Deterministic detection (field anchor + field names/labels + author-readable record values)
+    const deterministicMatches = DetectReferencedRestrictedFieldsDeterministic(entityInfo, MessageText, Conversation.AnchorType, Conversation.AnchorKey, readableRecordValues);
+    const detectedSet = new Set(deterministicMatches);
+    // Stage 2: Semantic LLM classification for any remaining FLS-governed fields
+    const text = (MessageText ?? '').trim();
+    const unmatchedFields = restrictedFields.filter((f) => !detectedSet.has(f.Name));
+    if (!params.SkipLLMStage && text.length > 0 && unmatchedFields.length > 0) {
+        const llmMatches = await runSemanticRestrictedFieldClassifier(entityInfo, unmatchedFields, text, Conversation.AnchorType, Conversation.AnchorKey, ContextUser);
+        for (const fieldName of llmMatches) {
+            detectedSet.add(fieldName);
+        }
+    }
+    const detectedFields = [...detectedSet];
+    // Also include any previously stamped restrictedFields on the conversation when checking author access
+    const existingMeta = ParseConversationAnchorMetadata(Conversation.AnchorMetadataObject ?? Conversation.AnchorMetadata);
+    const allThreadRestrictedFields = new Set(detectedFields);
+    if (Array.isArray(existingMeta?.restrictedFields)) {
+        for (const f of existingMeta.restrictedFields) {
+            if (typeof f === 'string' && f.trim()) {
+                allThreadRestrictedFields.add(f.trim());
+            }
+        }
+    }
+    // Check whether the authoring user is denied Read access on any referenced restricted field.
+    // Return a generic message without naming which field matched.
+    const authorDeniedFields = [...allThreadRestrictedFields].filter((f) => deniedLower.has(f.trim().toLowerCase()));
+    if (authorDeniedFields.length > 0) {
+        return {
+            Allowed: false,
+            Reason: 'You do not have permission to comment on restricted fields.',
+            DetectedFields: detectedFields,
+            AuthorDeniedFields: authorDeniedFields
+        };
+    }
+    // Stamp newly detected restricted fields onto the parent conversation's AnchorMetadataObject
+    if (detectedFields.length > 0) {
+        const { Metadata, Changed } = MergeRestrictedFieldsIntoAnchorMetadata(existingMeta, detectedFields);
+        if (Changed) {
+            Conversation.AnchorMetadataObject = Metadata;
+            if (Conversation.IsSaved) {
+                const saved = await Conversation.Save();
+                if (!saved) {
+                    LogError(`InspectAndStampRestrictedFieldsForComment: failed to update AnchorMetadata on conversation ${Conversation.ID}: ${Conversation.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+            }
+        }
+    }
+    return {
+        Allowed: true,
+        Reason: null,
+        DetectedFields: detectedFields,
+        AuthorDeniedFields: []
+    };
+}
+async function loadLinkedRecordRestrictedFieldValues(provider, contextUser, entityInfo, linkedRecordId, restrictedFields) {
+    if (provider?.ProviderType !== 'Database' || restrictedFields.length === 0) {
+        return null;
+    }
+    const pkFilter = BuildLinkedRecordPrimaryKeyFilter(entityInfo, linkedRecordId, provider);
+    if (!pkFilter) {
+        return null;
+    }
+    try {
+        const systemUser = (await WellKnownUserSource.Instance.GetSystemUser(provider)) ?? contextUser;
+        const rv = RunView.FromMetadataProvider(provider);
+        const fieldNames = [
+            ...entityInfo.PrimaryKeys.map((pk) => pk.Name),
+            ...restrictedFields.map((f) => f.Name)
+        ];
+        const result = await rv.RunView({
+            EntityName: entityInfo.Name,
+            ExtraFilter: pkFilter,
+            Fields: fieldNames,
+            MaxRows: 1,
+            ResultType: 'simple'
+        }, systemUser);
+        if (result.Success && result.Results && result.Results.length > 0) {
+            return result.Results[0];
+        }
+    }
+    catch (error) {
+        LogError(`loadLinkedRecordRestrictedFieldValues failed on ${entityInfo.Name} (${linkedRecordId}): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return null;
+}
+async function runSemanticRestrictedFieldClassifier(entityInfo, candidateFields, messageText, anchorType, anchorKey, contextUser) {
+    const prompt = {
+        EntityName: entityInfo.Name,
+        EntityDisplayName: entityInfo.DisplayNameOrName,
+        MessageText: messageText,
+        AnchorType: anchorType,
+        AnchorKey: anchorKey,
+        CandidateFields: candidateFields.map((f) => ({
+            Name: f.Name,
+            DisplayName: f.DisplayNameOrName,
+            Description: f.Description ?? null
+        }))
+    };
+    const validByLower = new Map();
+    for (const f of candidateFields) {
+        validByLower.set(f.Name.toLowerCase(), f.Name);
+    }
+    if (customRestrictedFieldClassifier) {
+        try {
+            const rawMatches = await customRestrictedFieldClassifier(prompt, contextUser);
+            return normalizeMatchedFieldNames(rawMatches, validByLower);
+        }
+        catch (error) {
+            LogError(`Custom RestrictedFieldLLMClassifier threw: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    return runDefaultAIEngineRestrictedFieldClassifier(prompt, contextUser, validByLower);
+}
+function normalizeMatchedFieldNames(rawNames, validByLower) {
+    if (!Array.isArray(rawNames)) {
+        return [];
+    }
+    const canonical = new Set();
+    for (const name of rawNames) {
+        if (typeof name === 'string') {
+            const found = validByLower.get(name.trim().toLowerCase());
+            if (found) {
+                canonical.add(found);
+            }
+        }
+    }
+    return [...canonical];
+}
+const RESTRICTED_FIELD_CLASSIFIER_PROMPT_NAME = 'Anchored Comment Restricted Field Classifier';
+async function runDefaultAIEngineRestrictedFieldClassifier(prompt, contextUser, validByLower) {
+    try {
+        await AIEngine.Instance.Config(false, contextUser);
+    }
+    catch (error) {
+        LogStatus(`[RestrictedFieldCommentClassifier] AIEngine.Config unavailable; skipping Stage 2 semantic classification: ${error instanceof Error ? error.message : String(error)}`);
+        return [];
+    }
+    const aiPrompt = AIEngine.Instance.Prompts?.find((p) => p.Name === RESTRICTED_FIELD_CLASSIFIER_PROMPT_NAME && p.Status === 'Active');
+    if (!aiPrompt) {
+        return [];
+    }
+    try {
+        const runner = new AIPromptRunner();
+        const params = new AIPromptParams();
+        params.prompt = aiPrompt;
+        params.data = prompt;
+        params.contextUser = contextUser;
+        const execution = await runner.ExecutePrompt(params);
+        if (!execution.success || !execution.result) {
+            LogStatus(`[RestrictedFieldCommentClassifier] Governed prompt "${RESTRICTED_FIELD_CLASSIFIER_PROMPT_NAME}" returned unsuccessful result: ${execution.errorMessage ?? 'unknown'}`);
+            return [];
+        }
+        const list = execution.result.restrictedFields;
+        if (Array.isArray(list)) {
+            return normalizeMatchedFieldNames(list.filter((item) => typeof item === 'string'), validByLower);
+        }
+    }
+    catch (error) {
+        LogStatus(`[RestrictedFieldCommentClassifier] Governed prompt "${RESTRICTED_FIELD_CLASSIFIER_PROMPT_NAME}" threw: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return [];
+}
+//# sourceMappingURL=RestrictedFieldCommentClassifier.js.map

package/dist/custom/RestrictedFieldCommentClassifier.js.map

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

package/dist/custom/query-extraction/childRowWriter.d.ts

@@ -0,0 +1,77 @@
+import type { IEntityDataProvider, IMetadataProvider, IRunViewProvider, UserInfo } from "@memberjunction/core";
+import type { MJQueryFieldEntity } from "@memberjunction/core-entities";
+import type { QueryExtractionResult, QueryFieldFact } from "./extractionTypes.js";
+/** Where the child rows are written, and as whom. */
+export interface ChildRowWriteContext {
+    readonly QueryID: string;
+    /**
+     * The caller's provider. The writes run in an entity transaction on it, joining the caller's
+     * transaction when one is open; a provider without entity transactions writes without one.
+     */
+    readonly Provider: IMetadataProvider & IRunViewProvider & Partial<Pick<IEntityDataProvider, 'SupportsEntityTransactions' | 'BeginEntityTransaction'>>;
+    /** The user the rows are read and written as: the system user for save-triggered extraction. */
+    readonly User: UserInfo;
+    /** Work out and report the changes without writing anything. */
+    readonly DryRun?: boolean;
+    /** The name a Query Entities change is reported under, for an entity ID; the ID when omitted. */
+    readonly EntityName?: (entityID: string) => string;
+}
+/** The child collection of a query a row belongs to. */
+export type QueryChildCollection = 'Fields' | 'Parameters' | 'Entities' | 'Dependencies';
+/** One child row the writes add, update or remove. */
+export interface ChildRowChange {
+    readonly Collection: QueryChildCollection;
+    readonly Action: 'Added' | 'Updated' | 'Removed';
+    /** The field or parameter name, the entity name, or the dependency's reference path. */
+    readonly Name: string;
+    /** For an update, the columns that change. */
+    readonly ChangedColumns: readonly string[];
+    /** For a field row, the entity field its output column comes from, when it maps to one. */
+    readonly SourceEntityFieldID: string | null;
+}
+/** What the writes changed, and which rows still have no description. */
+export interface ChildRowWriteSummary {
+    Added: number;
+    Updated: number;
+    Removed: number;
+    /** Every row added, updated or removed, in write order. */
+    readonly Changes: ChildRowChange[];
+    /** Authored parameters the SQL no longer uses: kept, and flagged on the query. */
+    readonly FlaggedParameters: string[];
+    /** Field rows with an empty description, for the description pass. */
+    readonly FieldsWithoutDescription: string[];
+    /** Parameter rows with an empty description, for the description pass. */
+    readonly ParametersWithoutDescription: string[];
+}
+/**
+ * Brings a query's child rows in line with its extracted facts, keeping what people authored.
+ *
+ * **Facts** are corrected on every row, including declared and `Manual` ones: a field's name
+ * casing, sequence, types, nullability, source and computed flag; whether a parameter exists
+ * (and its name casing); which entities and dependencies the query has.
+ *
+ * **Annotations** are never overwritten when authored (`DetectionMethod` `Manual`, or a
+ * non-empty value): descriptions, `ComputationDescription`, `IsSummary` / `SummaryDescription`,
+ * and a `Manual` parameter's type, required flag, default, sample, validation filters and
+ * server-set flag. A doc-comment description is authored too: it fills an empty description and
+ * replaces one extraction or an LLM wrote.
+ *
+ * An authored parameter the SQL no longer uses is kept (extraction flags it on the query); an
+ * auto-detected one is deleted. Rows keep their IDs. A `null` fact collection leaves its rows as
+ * they are. Existing rows are read from the database on the caller's provider, never a cache, so
+ * rows written earlier in the same transaction are seen.
+ *
+ * The writes are one unit of work: they run in an entity transaction on the caller's provider,
+ * which joins the caller's transaction when one is open (a nested scope), so a failed write rolls
+ * every write of this call back and throws. A provider without entity transactions (a client)
+ * writes without one.
+ *
+ * With `DryRun` the same changes are worked out and reported, and nothing is written.
+ */
+export declare function WriteExtractedChildRows(context: ChildRowWriteContext, result: QueryExtractionResult): Promise<ChildRowWriteSummary>;
+/**
+ * Sets a field row's facts (name casing, sequence, types, nullability, computed flag, source) from
+ * the extracted fact, leaving its annotations alone.
+ */
+export declare function ApplyFieldFacts(row: MJQueryFieldEntity, fact: QueryFieldFact): void;
+//# sourceMappingURL=childRowWriter.d.ts.map

package/dist/custom/query-extraction/childRowWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"childRowWriter.d.ts","sourceRoot":"","sources":["../../../src/custom/query-extraction/childRowWriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3H,OAAO,KAAK,EAGR,kBAAkB,EAErB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAGR,qBAAqB,EACrB,cAAc,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,4BAA4B,GAAG,wBAAwB,CAAC,CAAC,CAAC;IACtJ,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAED,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC;AAEzF,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,EAAE,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,4BAA4B,EAAE,MAAM,EAAE,CAAC;CACnD;AAYD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAWzI;AAsGD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAWnF"}

package/dist/custom/query-extraction/childRowWriter.js

@@ -0,0 +1,277 @@
+import { RunInEntityTransaction, RunMaybeSerial } from "@memberjunction/core";
+import { EscapeSQLString, NormalizeUUID, UUIDsEqual } from "@memberjunction/global";
+/**
+ * Brings a query's child rows in line with its extracted facts, keeping what people authored.
+ *
+ * **Facts** are corrected on every row, including declared and `Manual` ones: a field's name
+ * casing, sequence, types, nullability, source and computed flag; whether a parameter exists
+ * (and its name casing); which entities and dependencies the query has.
+ *
+ * **Annotations** are never overwritten when authored (`DetectionMethod` `Manual`, or a
+ * non-empty value): descriptions, `ComputationDescription`, `IsSummary` / `SummaryDescription`,
+ * and a `Manual` parameter's type, required flag, default, sample, validation filters and
+ * server-set flag. A doc-comment description is authored too: it fills an empty description and
+ * replaces one extraction or an LLM wrote.
+ *
+ * An authored parameter the SQL no longer uses is kept (extraction flags it on the query); an
+ * auto-detected one is deleted. Rows keep their IDs. A `null` fact collection leaves its rows as
+ * they are. Existing rows are read from the database on the caller's provider, never a cache, so
+ * rows written earlier in the same transaction are seen.
+ *
+ * The writes are one unit of work: they run in an entity transaction on the caller's provider,
+ * which joins the caller's transaction when one is open (a nested scope), so a failed write rolls
+ * every write of this call back and throws. A provider without entity transactions (a client)
+ * writes without one.
+ *
+ * With `DryRun` the same changes are worked out and reported, and nothing is written.
+ */
+export async function WriteExtractedChildRows(context, result) {
+    const stored = await loadStoredChildRows(context);
+    const summary = { Added: 0, Updated: 0, Removed: 0, Changes: [], FlaggedParameters: [], FieldsWithoutDescription: [], ParametersWithoutDescription: [] };
+    const writes = [];
+    if (result.Fields)
+        writes.push(...await fieldWrites(context, stored.Fields, result.Fields, summary));
+    writes.push(...await parameterWrites(context, stored.Parameters, result.Parameters, summary));
+    if (result.Entities)
+        writes.push(...await entityWrites(context, stored.Entities, result.Entities, summary));
+    if (result.Dependencies)
+        writes.push(...await dependencyWrites(context, stored.Dependencies, result.Dependencies, summary));
+    if (context.DryRun || writes.length === 0)
+        return summary;
+    await RunInEntityTransaction(context.Provider, () => runWrites(context, writes));
+    return summary;
+}
+/** Runs the writes; throws when any of them failed, so the enclosing transaction rolls them all back. */
+async function runWrites(context, writes) {
+    const outcomes = await RunMaybeSerial(context.Provider, [...writes]);
+    const failed = outcomes.filter(ok => !ok).length;
+    if (failed > 0)
+        throw new Error(`Query ${context.QueryID}: ${failed} of ${writes.length} child-row writes failed; none of them were kept.`);
+}
+async function loadStoredChildRows(context) {
+    const filter = `QueryID='${EscapeSQLString(context.QueryID)}'`;
+    const load = async (entityName) => {
+        const result = await context.Provider.RunView({ EntityName: entityName, ExtraFilter: filter, ResultType: 'entity_object', BypassCache: true, IgnoreMaxRows: true }, context.User);
+        if (!result.Success)
+            throw new Error(`Could not read the stored ${entityName} of query ${context.QueryID}: ${result.ErrorMessage}`);
+        return result.Results ?? [];
+    };
+    const [fields, parameters, entities, dependencies] = await Promise.all([
+        load('MJ: Query Fields'),
+        load('MJ: Query Parameters'),
+        load('MJ: Query Entities'),
+        load('MJ: Query Dependencies'),
+    ]);
+    return { Fields: fields, Parameters: parameters, Entities: entities, Dependencies: dependencies };
+}
+/**
+ * A write for `row` when it has unsaved changes; counts and records it as added or updated.
+ *
+ * `alsoChanged` names columns that changed although the entity's dirty check does not see it: a
+ * nullable bit column going between `null` and `false` reads as unchanged there. Such a row is
+ * still written (ignoring the dirty state) and the column is reported.
+ */
+function saveIfDirty(row, summary, label, alsoChanged = []) {
+    if (row.IsSaved && !row.Dirty && alsoChanged.length === 0)
+        return [];
+    const action = row.IsSaved ? 'Updated' : 'Added';
+    if (row.IsSaved)
+        summary.Updated++;
+    else
+        summary.Added++;
+    const dirtyColumns = row.IsSaved ? row.Fields.filter(f => f.Dirty).map(f => f.Name) : [];
+    const changedColumns = row.IsSaved ? [...dirtyColumns, ...alsoChanged.filter(c => !dirtyColumns.includes(c))] : [];
+    summary.Changes.push({ ...changeOf(label, action), ChangedColumns: changedColumns });
+    const ignoreDirtyState = row.IsSaved && !row.Dirty;
+    return [() => row.Save(ignoreDirtyState ? { IgnoreDirtyState: true } : undefined)];
+}
+function deleteRows(rows, summary, labelOf) {
+    summary.Removed += rows.length;
+    for (const row of rows)
+        summary.Changes.push(changeOf(labelOf(row), 'Removed'));
+    return rows.map(row => () => row.Delete());
+}
+function changeOf(label, action) {
+    return { Collection: label.Collection, Action: action, Name: label.Name, ChangedColumns: [], SourceEntityFieldID: label.SourceEntityFieldID ?? null };
+}
+function fieldLabel(row) {
+    return { Collection: 'Fields', Name: row.Name, SourceEntityFieldID: row.SourceEntityFieldID };
+}
+function parameterLabel(row) {
+    return { Collection: 'Parameters', Name: row.Name };
+}
+function byLowerName(rows) {
+    return new Map(rows.map(r => [r.Name.toLowerCase(), r]));
+}
+function isEmpty(value) {
+    return !value || value.trim().length === 0;
+}
+// ─── Fields ─────────────────────────────────────────────────────────────────
+async function fieldWrites(context, stored, facts, summary) {
+    const existing = byLowerName(stored);
+    const writes = [];
+    for (const fact of facts) {
+        let row = existing.get(fact.Name.toLowerCase());
+        existing.delete(fact.Name.toLowerCase());
+        if (!row)
+            row = await newRow(context, 'MJ: Query Fields', r => newField(r, context.QueryID, fact));
+        else
+            applyFieldAnnotations(row, fact);
+        const nullabilityChanged = row.IsSaved && (row.IsNullable ?? null) !== (fact.IsNullable ?? null);
+        ApplyFieldFacts(row, fact);
+        writes.push(...saveIfDirty(row, summary, fieldLabel(row), nullabilityChanged ? ['IsNullable'] : []));
+        if (isEmpty(row.Description))
+            summary.FieldsWithoutDescription.push(row.Name);
+    }
+    return [...writes, ...deleteRows([...existing.values()], summary, fieldLabel)];
+}
+function newField(row, queryID, fact) {
+    row.QueryID = queryID;
+    row.Description = fact.DocDescription ?? fact.SourceDescription;
+    row.IsSummary = false;
+    row.DetectionMethod = 'Database';
+}
+/**
+ * Sets a field row's facts (name casing, sequence, types, nullability, computed flag, source) from
+ * the extracted fact, leaving its annotations alone.
+ */
+export function ApplyFieldFacts(row, fact) {
+    row.Name = fact.Name;
+    row.Sequence = fact.Sequence;
+    row.SQLBaseType = fact.SQLBaseType;
+    row.SQLFullType = fact.SQLFullType;
+    row.IsNullable = fact.IsNullable;
+    row.IsComputed = fact.IsComputed;
+    row.SourceEntityID = fact.SourceEntityID;
+    row.SourceEntityFieldID = fact.SourceEntityFieldID;
+    row.SourceFieldName = fact.SourceFieldName;
+    row.SourceObjectName = fact.SourceObjectName;
+}
+/** A stored field's description and detection method: authored ones kept, a doc comment applied. */
+function applyFieldAnnotations(row, fact) {
+    const authored = row.DetectionMethod === 'Manual';
+    if (fact.DocDescription !== null && (!authored || isEmpty(row.Description)))
+        row.Description = fact.DocDescription;
+    if (!authored && row.DetectionMethod !== 'AI')
+        row.DetectionMethod = 'Database';
+    if (row.DetectionMethod === 'AI' && fact.DocDescription !== null)
+        row.DetectionMethod = 'Database';
+}
+// ─── Parameters ─────────────────────────────────────────────────────────────
+async function parameterWrites(context, stored, facts, summary) {
+    const existing = byLowerName(stored);
+    const writes = [];
+    for (const fact of facts) {
+        let row = existing.get(fact.Name.toLowerCase());
+        existing.delete(fact.Name.toLowerCase());
+        if (!row)
+            row = await newRow(context, 'MJ: Query Parameters', r => newParameter(r, context.QueryID, fact));
+        else
+            applyParameterAnnotations(row, fact);
+        row.Name = fact.Name;
+        writes.push(...saveIfDirty(row, summary, parameterLabel(row)));
+        if (isEmpty(row.Description))
+            summary.ParametersWithoutDescription.push(row.Name);
+    }
+    const leftover = [...existing.values()];
+    summary.FlaggedParameters.push(...leftover.filter(row => row.DetectionMethod === 'Manual').map(row => row.Name));
+    const unused = leftover.filter(row => row.DetectionMethod !== 'Manual');
+    return [...writes, ...deleteRows(unused, summary, parameterLabel)];
+}
+function newParameter(row, queryID, fact) {
+    row.QueryID = queryID;
+    row.Type = fact.Type ?? 'string';
+    row.IsRequired = fact.IsRequired;
+    row.DefaultValue = fact.DefaultValue;
+    row.SampleValue = fact.SampleValue;
+    row.Description = fact.DocDescription ?? fact.InheritedDescription;
+    row.IsServerSet = false;
+    row.DetectionMethod = 'Parser';
+}
+/**
+ * A stored parameter: a `Manual` row keeps every annotation (only an empty description is filled);
+ * an auto-detected row takes the template's type, required flag and default, keeps a non-empty
+ * sample and description, and takes a doc comment's description.
+ */
+function applyParameterAnnotations(row, fact) {
+    if (row.DetectionMethod === 'Manual') {
+        if (isEmpty(row.Description))
+            row.Description = fact.DocDescription ?? fact.InheritedDescription ?? row.Description;
+        return;
+    }
+    if (fact.Type !== null)
+        row.Type = fact.Type;
+    row.IsRequired = fact.IsRequired;
+    row.DefaultValue = fact.DefaultValue;
+    if (isEmpty(row.SampleValue))
+        row.SampleValue = fact.SampleValue;
+    if (fact.DocDescription !== null)
+        row.Description = fact.DocDescription;
+    else if (isEmpty(row.Description))
+        row.Description = fact.InheritedDescription;
+    row.DetectionMethod = 'Parser';
+}
+// ─── Entities ───────────────────────────────────────────────────────────────
+async function entityWrites(context, stored, facts, summary) {
+    const remaining = [...stored];
+    const writes = [];
+    const unmatched = facts.filter(fact => !takeRow(remaining, r => sameEntityLink(r, fact)));
+    for (const fact of unmatched) {
+        const row = takeRow(remaining, r => UUIDsEqual(r.EntityID, fact.EntityID))
+            ?? await newRow(context, 'MJ: Query Entities', r => newEntityLink(r, context.QueryID, fact));
+        row.AlternateBaseViewID = fact.AlternateBaseViewID;
+        writes.push(...saveIfDirty(row, summary, entityLabel(context, row)));
+    }
+    return [...writes, ...deleteRows(remaining, summary, row => entityLabel(context, row))];
+}
+function entityLabel(context, row) {
+    return { Collection: 'Entities', Name: context.EntityName ? context.EntityName(row.EntityID) : (row.Entity || row.EntityID) };
+}
+function sameEntityLink(row, fact) {
+    const abv = (id) => (id ? NormalizeUUID(id) : '');
+    return UUIDsEqual(row.EntityID, fact.EntityID) && abv(row.AlternateBaseViewID) === abv(fact.AlternateBaseViewID);
+}
+function newEntityLink(row, queryID, fact) {
+    row.QueryID = queryID;
+    row.EntityID = fact.EntityID;
+    row.DetectionMethod = 'Parser';
+    row.AutoDetectConfidenceScore = 1;
+}
+/** Removes and returns the first row matching `test`. */
+function takeRow(rows, test) {
+    const index = rows.findIndex(test);
+    return index < 0 ? undefined : rows.splice(index, 1)[0];
+}
+// ─── Dependencies ───────────────────────────────────────────────────────────
+async function dependencyWrites(context, stored, facts, summary) {
+    const remaining = [...stored];
+    const writes = [];
+    const seen = new Set();
+    for (const fact of facts) {
+        const key = `${NormalizeUUID(fact.DependsOnQueryID)}|${fact.ReferencePath.toLowerCase()}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const row = takeRow(remaining, r => UUIDsEqual(r.DependsOnQueryID, fact.DependsOnQueryID) && r.ReferencePath.toLowerCase() === fact.ReferencePath.toLowerCase())
+            ?? await newRow(context, 'MJ: Query Dependencies', r => newDependency(r, context.QueryID, fact));
+        row.ReferencePath = fact.ReferencePath;
+        row.Alias = fact.Alias;
+        row.ParameterMapping = fact.ParameterMapping;
+        writes.push(...saveIfDirty(row, summary, dependencyLabel(row)));
+    }
+    return [...writes, ...deleteRows(remaining, summary, dependencyLabel)];
+}
+function dependencyLabel(row) {
+    return { Collection: 'Dependencies', Name: row.ReferencePath };
+}
+function newDependency(row, queryID, fact) {
+    row.QueryID = queryID;
+    row.DependsOnQueryID = fact.DependsOnQueryID;
+    row.DetectionMethod = 'Auto';
+}
+async function newRow(context, entityName, init) {
+    const row = await context.Provider.GetEntityObject(entityName, context.User);
+    init(row);
+    return row;
+}
+//# sourceMappingURL=childRowWriter.js.map

package/dist/custom/query-extraction/childRowWriter.js.map

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