@polintpro/proposit-core 0.2.10 → 0.2.11

package/dist/lib/core/PremiseManager.js

@@ -1,873 +0,0 @@
-import { DefaultMap } from "../utils.js";
-import { sortedCopyById, sortedUnique } from "../utils/collections.js";
-import { buildDirectionalVacuity, kleeneAnd, kleeneIff, kleeneImplies, kleeneNot, kleeneOr, makeErrorIssue, makeValidationResult, } from "./evaluation/shared.js";
-import { DEFAULT_CHECKSUM_CONFIG } from "../consts.js";
-import { ChangeCollector } from "./ChangeCollector.js";
-import { computeHash, entityChecksum } from "./checksum.js";
-import { ExpressionManager } from "./ExpressionManager.js";
-import { VariableManager } from "./VariableManager.js";
-export class PremiseManager {
-    id;
-    extras;
-    rootExpressionId;
-    variables;
-    expressions;
-    expressionsByVariableId;
-    argument;
-    checksumConfig;
-    checksumDirty = true;
-    cachedChecksum;
-    constructor(id, argument, variables, extras, checksumConfig, positionConfig) {
-        this.id = id;
-        this.argument = argument;
-        this.extras = extras ?? {};
-        this.checksumConfig = checksumConfig;
-        this.rootExpressionId = undefined;
-        this.variables = variables;
-        this.expressions = new ExpressionManager([], positionConfig);
-        this.expressionsByVariableId = new DefaultMap(() => new Set());
-    }
-    /**
-     * Deletes all expressions that reference the given variable ID,
-     * including their subtrees. Operator collapse runs after each removal.
-     * Returns all removed expressions in the changeset.
-     */
-    deleteExpressionsUsingVariable(variableId) {
-        const expressionIds = this.expressionsByVariableId.get(variableId);
-        if (expressionIds.size === 0) {
-            return { result: [], changes: {} };
-        }
-        const collector = new ChangeCollector();
-        // Copy the set since removeExpression mutates expressionsByVariableId
-        const removed = [];
-        for (const exprId of [...expressionIds]) {
-            // The expression may already have been removed as part of a
-            // prior subtree deletion or operator collapse in this loop.
-            if (!this.expressions.getExpression(exprId))
-                continue;
-            const { result, changes } = this.removeExpression(exprId, true);
-            if (result)
-                removed.push(result);
-            if (changes.expressions) {
-                for (const e of changes.expressions.removed) {
-                    collector.removedExpression(e);
-                }
-            }
-        }
-        // Expressions in the collector already have checksums attached
-        // (from removeExpression's attachChangesetChecksums).
-        return {
-            result: removed,
-            changes: collector.toChangeset(),
-        };
-    }
-    /**
-     * Adds an expression to this premise's tree.
-     *
-     * If the expression has `parentId: null` it becomes the root; only one
-     * root is permitted per premise.  If `parentId` is non-null the parent
-     * must already exist within this premise.
-     *
-     * All other structural rules (`implies`/`iff` root-only, child limits,
-     * position uniqueness) are enforced by the underlying `ExpressionManager`.
-     *
-     * @throws If the premise already has a root expression and this one is also a root.
-     * @throws If the expression's parent does not exist in this premise.
-     * @throws If the expression is a variable reference and the variable has not been registered.
-     * @throws If the expression does not belong to this argument.
-     */
-    addExpression(expression) {
-        this.assertBelongsToArgument(expression.argumentId, expression.argumentVersion);
-        if (expression.type === "variable" &&
-            !this.variables.hasVariable(expression.variableId)) {
-            throw new Error(`Variable expression "${expression.id}" references non-existent variable "${expression.variableId}".`);
-        }
-        if (expression.parentId === null) {
-            if (this.rootExpressionId !== undefined) {
-                throw new Error(`Premise "${this.id}" already has a root expression.`);
-            }
-        }
-        else {
-            if (!this.expressions.getExpression(expression.parentId)) {
-                throw new Error(`Parent expression "${expression.parentId}" does not exist in this premise.`);
-            }
-        }
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            // Delegate structural validation (operator type checks, position
-            // uniqueness, child limits) to ExpressionManager.
-            this.expressions.addExpression(expression);
-            if (expression.parentId === null) {
-                this.rootExpressionId = expression.id;
-            }
-            if (expression.type === "variable") {
-                this.expressionsByVariableId
-                    .get(expression.variableId)
-                    .add(expression.id);
-            }
-            this.markDirty();
-            return {
-                result: this.attachExpressionChecksum({ ...expression }),
-                changes: this.attachChangesetChecksums(collector.toChangeset()),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Adds an expression as the last child of the given parent, with
-     * position computed automatically.
-     *
-     * If `parentId` is `null`, the expression becomes the root.
-     *
-     * @throws If the premise already has a root and parentId is null.
-     * @throws If the expression does not belong to this argument.
-     * @throws If the expression is a variable reference and the variable has not been registered.
-     */
-    appendExpression(parentId, expression) {
-        this.assertBelongsToArgument(expression.argumentId, expression.argumentVersion);
-        if (expression.type === "variable" &&
-            !this.variables.hasVariable(expression.variableId)) {
-            throw new Error(`Variable expression "${expression.id}" references non-existent variable "${expression.variableId}".`);
-        }
-        if (parentId === null) {
-            if (this.rootExpressionId !== undefined) {
-                throw new Error(`Premise "${this.id}" already has a root expression.`);
-            }
-        }
-        else {
-            if (!this.expressions.getExpression(parentId)) {
-                throw new Error(`Parent expression "${parentId}" does not exist in this premise.`);
-            }
-        }
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            this.expressions.appendExpression(parentId, expression);
-            if (parentId === null) {
-                this.syncRootExpressionId();
-            }
-            if (expression.type === "variable") {
-                this.expressionsByVariableId
-                    .get(expression.variableId)
-                    .add(expression.id);
-            }
-            this.markDirty();
-            const stored = this.expressions.getExpression(expression.id);
-            return {
-                result: this.attachExpressionChecksum({ ...stored }),
-                changes: this.attachChangesetChecksums(collector.toChangeset()),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Adds an expression immediately before or after an existing sibling,
-     * with position computed automatically.
-     *
-     * @throws If the sibling does not exist in this premise.
-     * @throws If the expression does not belong to this argument.
-     * @throws If the expression is a variable reference and the variable has not been registered.
-     */
-    addExpressionRelative(siblingId, relativePosition, expression) {
-        this.assertBelongsToArgument(expression.argumentId, expression.argumentVersion);
-        if (expression.type === "variable" &&
-            !this.variables.hasVariable(expression.variableId)) {
-            throw new Error(`Variable expression "${expression.id}" references non-existent variable "${expression.variableId}".`);
-        }
-        if (!this.expressions.getExpression(siblingId)) {
-            throw new Error(`Expression "${siblingId}" not found in this premise.`);
-        }
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            this.expressions.addExpressionRelative(siblingId, relativePosition, expression);
-            if (expression.type === "variable") {
-                this.expressionsByVariableId
-                    .get(expression.variableId)
-                    .add(expression.id);
-            }
-            this.markDirty();
-            const stored = this.expressions.getExpression(expression.id);
-            return {
-                result: this.attachExpressionChecksum({ ...stored }),
-                changes: this.attachChangesetChecksums(collector.toChangeset()),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Updates mutable fields of an existing expression in this premise.
-     *
-     * Only `position`, `variableId`, and `operator` may be updated. Structural
-     * fields (`id`, `parentId`, `type`, `argumentId`, `argumentVersion`,
-     * `checksum`) are forbidden — enforced by the underlying
-     * `ExpressionManager`.
-     *
-     * If `variableId` changes, the internal `expressionsByVariableId` index is
-     * updated so that cascade deletion (`deleteExpressionsUsingVariable`) stays
-     * correct.
-     *
-     * @throws If the expression does not exist in this premise.
-     * @throws If `variableId` references a non-existent variable.
-     */
-    updateExpression(expressionId, updates) {
-        const existing = this.expressions.getExpression(expressionId);
-        if (!existing) {
-            throw new Error(`Expression "${expressionId}" not found in premise "${this.id}".`);
-        }
-        if (updates.variableId !== undefined) {
-            if (!this.variables.hasVariable(updates.variableId)) {
-                throw new Error(`Variable expression "${expressionId}" references non-existent variable "${updates.variableId}".`);
-            }
-        }
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            const oldVariableId = existing.type === "variable" ? existing.variableId : undefined;
-            const updated = this.expressions.updateExpression(expressionId, updates);
-            if (updates.variableId !== undefined &&
-                oldVariableId !== undefined &&
-                oldVariableId !== updates.variableId) {
-                this.expressionsByVariableId
-                    .get(oldVariableId)
-                    ?.delete(expressionId);
-                this.expressionsByVariableId
-                    .get(updates.variableId)
-                    .add(expressionId);
-            }
-            const changeset = collector.toChangeset();
-            if (changeset.expressions !== undefined) {
-                this.markDirty();
-            }
-            return {
-                result: this.attachExpressionChecksum({
-                    ...updated,
-                }),
-                changes: this.attachChangesetChecksums(changeset),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Removes an expression and its entire descendant subtree, then collapses
-     * any ancestor operators with fewer than two children (same semantics as
-     * before).  Returns the removed root expression, or `undefined` if not
-     * found.
-     *
-     * `rootExpressionId` is recomputed after every removal because operator
-     * collapse can silently promote a new expression into the root slot.
-     */
-    removeExpression(expressionId, deleteSubtree) {
-        // Snapshot the expression before removal (for result).
-        const snapshot = this.expressions.getExpression(expressionId);
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            if (!snapshot) {
-                return {
-                    result: undefined,
-                    changes: collector.toChangeset(),
-                };
-            }
-            if (deleteSubtree) {
-                // Snapshot the subtree before deletion so we can clean up
-                // expressionsByVariableId for cascade-deleted descendants — they are
-                // not individually surfaced by ExpressionManager.removeExpression.
-                const subtree = this.collectSubtree(expressionId);
-                this.expressions.removeExpression(expressionId, true);
-                for (const expr of subtree) {
-                    if (expr.type === "variable") {
-                        this.expressionsByVariableId
-                            .get(expr.variableId)
-                            ?.delete(expr.id);
-                    }
-                }
-            }
-            else {
-                // Only clean up expressionsByVariableId for the removed
-                // expression itself — children survive promotion.
-                if (snapshot.type === "variable") {
-                    this.expressionsByVariableId
-                        .get(snapshot.variableId)
-                        ?.delete(snapshot.id);
-                }
-                this.expressions.removeExpression(expressionId, false);
-            }
-            this.syncRootExpressionId();
-            this.markDirty();
-            return {
-                result: this.attachExpressionChecksum({ ...snapshot }),
-                changes: this.attachChangesetChecksums(collector.toChangeset()),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Splices a new expression between existing nodes in the tree.  The new
-     * expression inherits the tree slot of the anchor node
-     * (`leftNodeId ?? rightNodeId`).
-     *
-     * `rootExpressionId` is recomputed after every insertion because the
-     * anchor may have been the root.
-     *
-     * See `ArgumentEngine.insertExpression` for the full contract; the same
-     * rules apply here.
-     *
-     * @throws If the expression does not belong to this argument.
-     * @throws If the expression is a variable reference and the variable has not been registered.
-     */
-    insertExpression(expression, leftNodeId, rightNodeId) {
-        this.assertBelongsToArgument(expression.argumentId, expression.argumentVersion);
-        if (expression.type === "variable" &&
-            !this.variables.hasVariable(expression.variableId)) {
-            throw new Error(`Variable expression "${expression.id}" references non-existent variable "${expression.variableId}".`);
-        }
-        const collector = new ChangeCollector();
-        this.expressions.setCollector(collector);
-        try {
-            this.expressions.insertExpression(expression, leftNodeId, rightNodeId);
-            if (expression.type === "variable") {
-                this.expressionsByVariableId
-                    .get(expression.variableId)
-                    .add(expression.id);
-            }
-            this.syncRootExpressionId();
-            this.markDirty();
-            const stored = this.expressions.getExpression(expression.id);
-            return {
-                result: this.attachExpressionChecksum({ ...stored }),
-                changes: this.attachChangesetChecksums(collector.toChangeset()),
-            };
-        }
-        finally {
-            this.expressions.setCollector(null);
-        }
-    }
-    /**
-     * Returns an expression by ID, or `undefined` if not found in this
-     * premise.
-     */
-    getExpression(id) {
-        const expr = this.expressions.getExpression(id);
-        if (!expr)
-            return undefined;
-        return this.attachExpressionChecksum(expr);
-    }
-    getId() {
-        return this.id;
-    }
-    getExtras() {
-        return { ...this.extras };
-    }
-    setExtras(extras) {
-        this.extras = { ...extras };
-        this.markDirty();
-        return { result: { ...this.extras }, changes: {} };
-    }
-    getRootExpressionId() {
-        return this.rootExpressionId;
-    }
-    getRootExpression() {
-        if (this.rootExpressionId === undefined) {
-            return undefined;
-        }
-        const expr = this.expressions.getExpression(this.rootExpressionId);
-        if (!expr)
-            return undefined;
-        return this.attachExpressionChecksum(expr);
-    }
-    /**
-     * Returns all argument-level variables (from the shared VariableManager)
-     * sorted by ID. Since the VariableManager is shared across all premises,
-     * this returns every registered variable — not just those referenced by
-     * expressions in this premise.
-     */
-    getVariables() {
-        return sortedCopyById(this.variables.toArray());
-    }
-    getExpressions() {
-        const fields = this.checksumConfig?.expressionFields ??
-            DEFAULT_CHECKSUM_CONFIG.expressionFields;
-        return sortedCopyById(this.expressions.toArray().map((e) => ({
-            ...e,
-            checksum: entityChecksum(e, fields),
-        })));
-    }
-    getChildExpressions(parentId) {
-        return this.expressions
-            .getChildExpressions(parentId)
-            .map((expr) => this.attachExpressionChecksum(expr));
-    }
-    /**
-     * Returns `true` if the root expression is an `implies` or `iff` operator,
-     * meaning this premise expresses a logical inference relationship.
-     */
-    isInference() {
-        const root = this.getRootExpression();
-        return (root?.type === "operator" &&
-            (root.operator === "implies" || root.operator === "iff"));
-    }
-    /**
-     * Returns `true` if this premise does not have an inference operator at its
-     * root (i.e. it is a constraint premise).  Equivalent to `!isInference()`.
-     */
-    isConstraint() {
-        return !this.isInference();
-    }
-    validateEvaluability() {
-        const issues = [];
-        const roots = this.expressions.getChildExpressions(null);
-        if (this.expressions.toArray().length === 0) {
-            issues.push(makeErrorIssue({
-                code: "PREMISE_EMPTY",
-                message: `Premise "${this.id}" has no expressions to evaluate.`,
-                premiseId: this.id,
-            }));
-            return makeValidationResult(issues);
-        }
-        if (roots.length === 0) {
-            issues.push(makeErrorIssue({
-                code: "PREMISE_ROOT_MISSING",
-                message: `Premise "${this.id}" has expressions but no root expression.`,
-                premiseId: this.id,
-            }));
-        }
-        if (this.rootExpressionId === undefined) {
-            issues.push(makeErrorIssue({
-                code: "PREMISE_ROOT_MISSING",
-                message: `Premise "${this.id}" does not have rootExpressionId set.`,
-                premiseId: this.id,
-            }));
-        }
-        else if (!this.expressions.getExpression(this.rootExpressionId)) {
-            issues.push(makeErrorIssue({
-                code: "PREMISE_ROOT_MISMATCH",
-                message: `Premise "${this.id}" rootExpressionId "${this.rootExpressionId}" does not exist.`,
-                premiseId: this.id,
-                expressionId: this.rootExpressionId,
-            }));
-        }
-        else if (roots[0] && roots[0].id !== this.rootExpressionId) {
-            issues.push(makeErrorIssue({
-                code: "PREMISE_ROOT_MISMATCH",
-                message: `Premise "${this.id}" rootExpressionId "${this.rootExpressionId}" does not match actual root "${roots[0].id}".`,
-                premiseId: this.id,
-                expressionId: this.rootExpressionId,
-            }));
-        }
-        for (const expr of this.expressions.toArray()) {
-            if (expr.type === "variable" &&
-                !this.variables.hasVariable(expr.variableId)) {
-                issues.push(makeErrorIssue({
-                    code: "EXPR_VARIABLE_UNDECLARED",
-                    message: `Expression "${expr.id}" references undeclared variable "${expr.variableId}".`,
-                    premiseId: this.id,
-                    expressionId: expr.id,
-                    variableId: expr.variableId,
-                }));
-            }
-            if (expr.type !== "operator" && expr.type !== "formula") {
-                continue;
-            }
-            const children = this.expressions.getChildExpressions(expr.id);
-            if (expr.type === "formula") {
-                if (children.length !== 1) {
-                    issues.push(makeErrorIssue({
-                        code: "EXPR_CHILD_COUNT_INVALID",
-                        message: `Formula expression "${expr.id}" must have exactly 1 child; found ${children.length}.`,
-                        premiseId: this.id,
-                        expressionId: expr.id,
-                    }));
-                }
-                continue;
-            }
-            if (expr.operator === "not" && children.length !== 1) {
-                issues.push(makeErrorIssue({
-                    code: "EXPR_CHILD_COUNT_INVALID",
-                    message: `Operator "${expr.id}" (not) must have exactly 1 child; found ${children.length}.`,
-                    premiseId: this.id,
-                    expressionId: expr.id,
-                }));
-            }
-            if ((expr.operator === "implies" || expr.operator === "iff") &&
-                children.length !== 2) {
-                issues.push(makeErrorIssue({
-                    code: "EXPR_CHILD_COUNT_INVALID",
-                    message: `Operator "${expr.id}" (${expr.operator}) must have exactly 2 children; found ${children.length}.`,
-                    premiseId: this.id,
-                    expressionId: expr.id,
-                }));
-            }
-            if ((expr.operator === "and" || expr.operator === "or") &&
-                children.length < 2) {
-                issues.push(makeErrorIssue({
-                    code: "EXPR_CHILD_COUNT_INVALID",
-                    message: `Operator "${expr.id}" (${expr.operator}) must have at least 2 children; found ${children.length}.`,
-                    premiseId: this.id,
-                    expressionId: expr.id,
-                }));
-            }
-            if (expr.operator === "implies" || expr.operator === "iff") {
-                const childPositions = new Set(children.map((child) => child.position));
-                if (!childPositions.has(0) || !childPositions.has(1)) {
-                    issues.push(makeErrorIssue({
-                        code: "EXPR_BINARY_POSITIONS_INVALID",
-                        message: `Operator "${expr.id}" (${expr.operator}) must have children at positions 0 and 1.`,
-                        premiseId: this.id,
-                        expressionId: expr.id,
-                    }));
-                }
-            }
-        }
-        return makeValidationResult(issues);
-    }
-    /**
-     * Evaluates the premise under a three-valued expression assignment.
-     *
-     * Variable values are looked up in `assignment.variables` using Kleene
-     * three-valued logic (`null` = unknown). Missing variables default to `null`.
-     * Expressions listed in `assignment.rejectedExpressionIds` evaluate to
-     * `false` and their children are not evaluated.
-     *
-     * For inference premises (`implies`/`iff`), an `inferenceDiagnostic` is
-     * computed with three-valued fields unless the root is rejected.
-     */
-    evaluate(assignment, options) {
-        const validation = this.validateEvaluability();
-        if (!validation.ok) {
-            throw new Error(`Premise "${this.id}" is not evaluable: ${validation.issues
-                .map((issue) => issue.code)
-                .join(", ")}`);
-        }
-        const rootExpressionId = this.rootExpressionId;
-        const referencedVariableIds = sortedUnique(this.expressions
-            .toArray()
-            .filter((expr) => expr.type === "variable")
-            .map((expr) => expr.variableId));
-        if (options?.strictUnknownKeys || options?.requireExactCoverage) {
-            const knownVariableIds = new Set(referencedVariableIds);
-            const unknownKeys = Object.keys(assignment.variables).filter((variableId) => !knownVariableIds.has(variableId));
-            if (unknownKeys.length > 0) {
-                throw new Error(`Assignment contains unknown variable IDs for premise "${this.id}": ${unknownKeys.join(", ")}`);
-            }
-        }
-        const expressionValues = {};
-        const evaluateExpression = (expressionId) => {
-            const expression = this.expressions.getExpression(expressionId);
-            if (!expression) {
-                throw new Error(`Expression "${expressionId}" was not found.`);
-            }
-            if (assignment.rejectedExpressionIds.includes(expression.id)) {
-                expressionValues[expression.id] = false;
-                return false;
-            }
-            if (expression.type === "variable") {
-                const value = assignment.variables[expression.variableId] ?? null;
-                expressionValues[expression.id] = value;
-                return value;
-            }
-            const children = this.expressions.getChildExpressions(expression.id);
-            let value;
-            if (expression.type === "formula") {
-                value = evaluateExpression(children[0].id);
-                expressionValues[expression.id] = value;
-                return value;
-            }
-            switch (expression.operator) {
-                case "not":
-                    value = kleeneNot(evaluateExpression(children[0].id));
-                    break;
-                case "and":
-                    value = children.reduce((acc, child) => kleeneAnd(acc, evaluateExpression(child.id)), true);
-                    break;
-                case "or":
-                    value = children.reduce((acc, child) => kleeneOr(acc, evaluateExpression(child.id)), false);
-                    break;
-                case "implies": {
-                    const left = children.find((child) => child.position === 0);
-                    const right = children.find((child) => child.position === 1);
-                    value = kleeneImplies(evaluateExpression(left.id), evaluateExpression(right.id));
-                    break;
-                }
-                case "iff": {
-                    const left = children.find((child) => child.position === 0);
-                    const right = children.find((child) => child.position === 1);
-                    value = kleeneIff(evaluateExpression(left.id), evaluateExpression(right.id));
-                    break;
-                }
-            }
-            expressionValues[expression.id] = value;
-            return value;
-        };
-        const rootValue = evaluateExpression(rootExpressionId);
-        const variableValues = {};
-        for (const variableId of referencedVariableIds) {
-            variableValues[variableId] =
-                assignment.variables[variableId] ?? null;
-        }
-        let inferenceDiagnostic;
-        if (this.isInference() &&
-            !assignment.rejectedExpressionIds.includes(rootExpressionId)) {
-            const root = this.expressions.getExpression(rootExpressionId);
-            if (root?.type === "operator") {
-                const children = this.expressions.getChildExpressions(root.id);
-                const left = children.find((child) => child.position === 0);
-                const right = children.find((child) => child.position === 1);
-                if (left && right) {
-                    const leftValue = expressionValues[left.id];
-                    const rightValue = expressionValues[right.id];
-                    if (root.operator === "implies") {
-                        inferenceDiagnostic = {
-                            kind: "implies",
-                            premiseId: this.id,
-                            rootExpressionId,
-                            leftValue,
-                            rightValue,
-                            rootValue,
-                            antecedentTrue: leftValue,
-                            consequentTrue: rightValue,
-                            isVacuouslyTrue: kleeneNot(leftValue),
-                            fired: leftValue,
-                            firedAndHeld: kleeneAnd(leftValue, rightValue),
-                        };
-                    }
-                    else if (root.operator === "iff") {
-                        const leftToRight = buildDirectionalVacuity(leftValue, rightValue);
-                        const rightToLeft = buildDirectionalVacuity(rightValue, leftValue);
-                        inferenceDiagnostic = {
-                            kind: "iff",
-                            premiseId: this.id,
-                            rootExpressionId,
-                            leftValue,
-                            rightValue,
-                            rootValue,
-                            leftToRight,
-                            rightToLeft,
-                            bothSidesTrue: kleeneAnd(leftValue, rightValue),
-                            bothSidesFalse: kleeneAnd(kleeneNot(leftValue), kleeneNot(rightValue)),
-                        };
-                    }
-                }
-            }
-        }
-        return {
-            premiseId: this.id,
-            premiseType: this.isInference() ? "inference" : "constraint",
-            rootExpressionId,
-            rootValue,
-            expressionValues,
-            variableValues,
-            inferenceDiagnostic,
-        };
-    }
-    /**
-     * Returns a human-readable string of this premise's expression tree using
-     * standard logical notation (∧ ∨ ¬ → ↔).  Missing operands are rendered
-     * as `(?)`.  Returns an empty string when the premise has no expressions.
-     */
-    toDisplayString() {
-        if (this.rootExpressionId === undefined) {
-            return "";
-        }
-        return this.renderExpression(this.rootExpressionId);
-    }
-    /**
-     * Returns the set of variable IDs referenced by expressions in this premise.
-     * Only variables that appear in `type: "variable"` expression nodes are
-     * included — not all variables in the shared VariableManager.
-     */
-    getReferencedVariableIds() {
-        const ids = new Set();
-        for (const expr of this.expressions.toArray()) {
-            if (expr.type === "variable") {
-                ids.add(expr.variableId);
-            }
-        }
-        return ids;
-    }
-    /**
-     * Returns a serialisable snapshot of this premise conforming to
-     * `TCorePremise`.  `variables` contains only the variables that are actually
-     * referenced by expressions in this premise.
-     */
-    toData() {
-        const expressions = this.getExpressions();
-        const referencedVariableIds = new Set();
-        for (const expr of expressions) {
-            if (expr.type === "variable") {
-                referencedVariableIds.add(expr.variableId);
-            }
-        }
-        const variables = Array.from(referencedVariableIds).sort();
-        return {
-            ...this.extras,
-            id: this.id,
-            rootExpressionId: this.rootExpressionId,
-            variables,
-            expressions,
-            checksum: this.checksum(),
-        };
-    }
-    /**
-     * Returns a premise-level checksum combining all entity checksums.
-     * Computed lazily -- only recalculated when state has changed.
-     */
-    checksum() {
-        if (this.checksumDirty || this.cachedChecksum === undefined) {
-            this.cachedChecksum = this.computeChecksum();
-            this.checksumDirty = false;
-        }
-        return this.cachedChecksum;
-    }
-    // -------------------------------------------------------------------------
-    // Private helpers
-    // -------------------------------------------------------------------------
-    attachExpressionChecksum(expr) {
-        const fields = this.checksumConfig?.expressionFields ??
-            DEFAULT_CHECKSUM_CONFIG.expressionFields;
-        return {
-            ...expr,
-            checksum: entityChecksum(expr, fields),
-        };
-    }
-    attachVariableChecksum(v) {
-        const fields = this.checksumConfig?.variableFields ??
-            DEFAULT_CHECKSUM_CONFIG.variableFields;
-        return {
-            ...v,
-            checksum: entityChecksum(v, fields),
-        };
-    }
-    attachChangesetChecksums(changes) {
-        const result = {
-            ...changes,
-        };
-        if (changes.expressions) {
-            result.expressions = {
-                added: changes.expressions.added.map((e) => this.attachExpressionChecksum(e)),
-                modified: changes.expressions.modified.map((e) => this.attachExpressionChecksum(e)),
-                removed: changes.expressions.removed.map((e) => this.attachExpressionChecksum(e)),
-            };
-        }
-        // Variables in the changeset should already have checksums
-        // (from ArgumentEngine.addVariable), but cast for type safety
-        if (changes.variables) {
-            result.variables =
-                changes.variables;
-        }
-        return result;
-    }
-    computeChecksum() {
-        const config = this.checksumConfig;
-        const parts = [];
-        // Premise metadata
-        parts.push(entityChecksum({
-            id: this.id,
-            rootExpressionId: this.rootExpressionId,
-        }, config?.premiseFields ?? DEFAULT_CHECKSUM_CONFIG.premiseFields));
-        // Variable checksums (sorted by ID for determinism)
-        for (const v of this.getVariables()) {
-            parts.push(entityChecksum(v, config?.variableFields ??
-                DEFAULT_CHECKSUM_CONFIG.variableFields));
-        }
-        // Expression checksums (sorted by ID for determinism)
-        for (const e of this.getExpressions()) {
-            parts.push(entityChecksum(e, config?.expressionFields ??
-                DEFAULT_CHECKSUM_CONFIG.expressionFields));
-        }
-        return computeHash(parts.join(":"));
-    }
-    /** Invalidate the cached checksum so the next call recomputes it. */
-    markDirty() {
-        this.checksumDirty = true;
-    }
-    /**
-     * Re-reads the single root from ExpressionManager after any operation
-     * that may have caused operator collapse to silently change the root.
-     */
-    syncRootExpressionId() {
-        const roots = this.expressions.getChildExpressions(null);
-        this.rootExpressionId = roots[0]?.id;
-    }
-    collectSubtree(rootId) {
-        const result = [];
-        const stack = [rootId];
-        while (stack.length > 0) {
-            const id = stack.pop();
-            const expr = this.expressions.getExpression(id);
-            if (!expr)
-                continue;
-            result.push(expr);
-            for (const child of this.expressions.getChildExpressions(id)) {
-                stack.push(child.id);
-            }
-        }
-        return result;
-    }
-    assertBelongsToArgument(argumentId, argumentVersion) {
-        if (argumentId !== this.argument.id) {
-            throw new Error(`Entity argumentId "${argumentId}" does not match engine argument ID "${this.argument.id}".`);
-        }
-        if (argumentVersion !== this.argument.version) {
-            throw new Error(`Entity argumentVersion "${argumentVersion}" does not match engine argument version "${this.argument.version}".`);
-        }
-    }
-    renderExpression(expressionId) {
-        const expression = this.expressions.getExpression(expressionId);
-        if (!expression) {
-            throw new Error(`Expression "${expressionId}" was not found.`);
-        }
-        if (expression.type === "variable") {
-            const variable = this.variables.getVariable(expression.variableId);
-            if (!variable) {
-                throw new Error(`Variable "${expression.variableId}" for expression "${expressionId}" was not found.`);
-            }
-            return variable.symbol;
-        }
-        if (expression.type === "formula") {
-            const children = this.expressions.getChildExpressions(expression.id);
-            if (children.length === 0) {
-                return "(?)";
-            }
-            return `(${this.renderExpression(children[0].id)})`;
-        }
-        const children = this.expressions.getChildExpressions(expression.id);
-        if (expression.operator === "not") {
-            if (children.length === 0) {
-                return `${this.operatorSymbol(expression.operator)} (?)`;
-            }
-            return `${this.operatorSymbol(expression.operator)}(${this.renderExpression(children[0].id)})`;
-        }
-        if (children.length === 0) {
-            return "(?)";
-        }
-        const renderedChildren = children.map((child) => this.renderExpression(child.id));
-        return `(${renderedChildren.join(` ${this.operatorSymbol(expression.operator)} `)})`;
-    }
-    operatorSymbol(operator) {
-        switch (operator) {
-            case "and":
-                return "∧";
-            case "or":
-                return "∨";
-            case "implies":
-                return "→";
-            case "iff":
-                return "↔";
-            case "not":
-                return "¬";
-        }
-    }
-}
-//# sourceMappingURL=PremiseManager.js.map