Function diffArguments

diffArguments<
    TArg extends
        {
            checksum: string;
            combinedChecksum: string;
            descendantChecksum: string
            | null;
            id: string;
            version: number;
        } = {
        checksum: string;
        combinedChecksum: string;
        descendantChecksum: string
        | null;
        id: string;
        version: number;
    },
    TPremise extends
        | {
            argumentId: string;
            argumentVersion: number;
            checksum: string;
            combinedChecksum: string;
            descendantChecksum: string
            | null;
            enthymeme?: true;
            id: string;
            type: "freeform";
        }
        | {
            argumentId: string;
            argumentVersion: number;
            checksum: string;
            combinedChecksum: string;
            derivedClaimId: string;
            descendantChecksum: string
            | null;
            enthymeme?: true;
            id: string;
            type: "derivation";
        } = | {
        argumentId: string;
        argumentVersion: number;
        checksum: string;
        combinedChecksum: string;
        descendantChecksum: string
        | null;
        enthymeme?: true;
        id: string;
        type: "freeform";
    }
    | {
        argumentId: string;
        argumentVersion: number;
        checksum: string;
        combinedChecksum: string;
        derivedClaimId: string;
        descendantChecksum: string
        | null;
        enthymeme?: true;
        id: string;
        type: "derivation";
    },
    TExpr extends TCorePropositionalExpression = TCorePropositionalExpression,
    TVar extends

            | {
                argumentId: string;
                argumentVersion: number;
                checksum: string;
                claimId: string;
                claimVersion: number;
                id: string;
                symbol: string;
            }
            | {
                argumentId: string;
                argumentVersion: number;
                boundArgumentId: string;
                boundArgumentVersion: number;
                boundPremiseId: string;
                checksum: string;
                id: string;
                symbol: string;
            } = | {
        argumentId: string;
        argumentVersion: number;
        checksum: string;
        claimId: string;
        claimVersion: number;
        id: string;
        symbol: string;
    }
    | {
        argumentId: string;
        argumentVersion: number;
        boundArgumentId: string;
        boundArgumentVersion: number;
        boundPremiseId: string;
        checksum: string;
        id: string;
        symbol: string;
    },
>(
    engineA: ArgumentEngine<TArg, TPremise, TExpr, TVar>,
    engineB: ArgumentEngine<TArg, TPremise, TExpr, TVar>,
    options?: TCoreDiffOptions<TArg, TVar, TPremise, TExpr>,
): TCoreArgumentDiff<TArg, TVar, TPremise, TExpr>
Computes a structural diff between two argument engines.

Compares argument metadata, variables, premises (with nested expression diffs), and role assignments. Uses pluggable comparators that default to the defaultCompare* functions.

Four-state enrichment: Each modified entity carries a state field discriminating modified-own (the entity itself changed) from modified-within (only contained children or references changed). The modified-within state also marks premises whose claim-bound variables changed outside the premise — reference-edge propagation that surfaces downstream impacts of a claim edit.

Id-stability contract: The id-stability contract matters because the modified-own/modified-within states are only expressible when an entity's id survives a content edit; if ids churn, the diff can only report add+remove. Every version-producing path must preserve the id of any entity that logically persists across a version bump; mint a new id only for something genuinely new; drop an id only for something genuinely gone.
Type Parameters
- TArg extends {
      checksum: string;
      combinedChecksum: string;
      descendantChecksum: string | null;
      id: string;
      version: number;
  } = {
      checksum: string;
      combinedChecksum: string;
      descendantChecksum: string | null;
      id: string;
      version: number;
  }
- TPremise extends
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          combinedChecksum: string;
          descendantChecksum: string
          | null;
          enthymeme?: true;
          id: string;
          type: "freeform";
      }
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          combinedChecksum: string;
          derivedClaimId: string;
          descendantChecksum: string
          | null;
          enthymeme?: true;
          id: string;
          type: "derivation";
      } =
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          combinedChecksum: string;
          descendantChecksum: string
          | null;
          enthymeme?: true;
          id: string;
          type: "freeform";
      }
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          combinedChecksum: string;
          derivedClaimId: string;
          descendantChecksum: string
          | null;
          enthymeme?: true;
          id: string;
          type: "derivation";
      }
- TExpr extends TCorePropositionalExpression = TCorePropositionalExpression
- TVar extends
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          claimId: string;
          claimVersion: number;
          id: string;
          symbol: string;
      }
      | {
          argumentId: string;
          argumentVersion: number;
          boundArgumentId: string;
          boundArgumentVersion: number;
          boundPremiseId: string;
          checksum: string;
          id: string;
          symbol: string;
      } =
      | {
          argumentId: string;
          argumentVersion: number;
          checksum: string;
          claimId: string;
          claimVersion: number;
          id: string;
          symbol: string;
      }
      | {
          argumentId: string;
          argumentVersion: number;
          boundArgumentId: string;
          boundArgumentVersion: number;
          boundPremiseId: string;
          checksum: string;
          id: string;
          symbol: string;
      }
Parameters
- engineA: ArgumentEngine<TArg, TPremise, TExpr, TVar>
- engineB: ArgumentEngine<TArg, TPremise, TExpr, TVar>
- Optionaloptions: TCoreDiffOptions<TArg, TVar, TPremise, TExpr>
Returns TCoreArgumentDiff<TArg, TVar, TPremise, TExpr>
- Defined in src/lib/core/diff.ts:365

Function diffArguments

Type Parameters

Parameters

Returns TCoreArgumentDiff<TArg, TVar, TPremise, TExpr>

Settings