@geotechcli/core 0.4.109 → 0.4.111

package/dist/fem/support-design.d.ts

@@ -0,0 +1,124 @@
+import type { FemConvergencePolicy } from './engineering-evidence.js';
+import type { FemAssumption } from './types.js';
+export type FemSupportMemberKind = 'strut' | 'brace';
+export type FemSupportDesignStatus = 'accepted' | 'blocked';
+export interface FemSupportDesignUnits {
+    length: 'm';
+    force: 'kN';
+    stress: 'MPa';
+    area: 'm2';
+    moment: 'kN-m';
+    momentOfInertia: 'm4';
+    sectionModulus: 'm3';
+    utilization: 'ratio';
+}
+export interface FemSupportDemandSource {
+    source: 'fem-result-envelope' | 'support-reaction-screening' | 'reviewed-hand-calculation';
+    loadCombination: string;
+    description: string;
+    caseId?: string;
+    stageId?: string;
+    resultHashSha256?: string;
+}
+export interface FemSupportMemberDemand {
+    axialCompressionDemandKn: number;
+    bendingMomentDemandKnM?: number;
+    source: FemSupportDemandSource;
+}
+export interface FemSupportMemberProperties {
+    id: string;
+    kind: FemSupportMemberKind;
+    label?: string;
+    sectionLabel?: string;
+    unbracedLengthM: number;
+    effectiveLengthFactor: number;
+    areaM2: number;
+    weakAxisMomentOfInertiaM4: number;
+    sectionModulusM3?: number;
+    yieldStrengthMpa: number;
+    elasticModulusMpa: number;
+}
+export interface FemSupportDesignFactors {
+    demandFactor?: number;
+    resistanceFactorCompression?: number;
+    resistanceFactorFlexure?: number;
+    maximumSlendernessRatio?: number;
+}
+export interface FemSupportDesignReviewer {
+    name: string;
+    licenseId: string;
+    jurisdiction: string;
+}
+export interface FemSupportDesignReviewMetadata {
+    schemaVersion: 'fem-support-design-review-metadata.v1';
+    reviewer: FemSupportDesignReviewer;
+    reviewedAt: string;
+    assumptions: FemAssumption[];
+    limitations: string[];
+}
+export interface FemSupportMemberDesignCheckInput {
+    schemaVersion: 'fem-support-member-design-input.v1';
+    units: FemSupportDesignUnits;
+    member: FemSupportMemberProperties;
+    demand: FemSupportMemberDemand;
+    factors?: FemSupportDesignFactors;
+    review: FemSupportDesignReviewMetadata;
+    policy?: FemConvergencePolicy;
+}
+export interface FemSupportMemberDesignInputValidation {
+    schemaVersion: 'fem-support-member-design-input-validation.v1';
+    status: FemSupportDesignStatus;
+    blockerCodes: string[];
+    warnings: string[];
+}
+export interface FemSupportMemberLimitState {
+    id: 'axial-yield' | 'euler-buckling' | 'flexural-yield' | 'combined-axial-flexure' | 'slenderness';
+    demand: number;
+    capacity: number;
+    unit: 'kN' | 'kN-m' | 'ratio';
+    utilization: number;
+    status: FemSupportDesignStatus;
+}
+export interface FemSupportMemberConvergenceMetadata {
+    schemaVersion: 'fem-support-member-convergence.v1';
+    method: 'closed-form-limit-state-evaluation';
+    deterministic: true;
+    status: 'converged';
+    iterations: 1;
+    residualRatio: 0;
+    tolerance: number;
+}
+export interface FemSupportMemberDesignCheckResult {
+    schemaVersion: 'fem-support-member-design-check.v1';
+    designScope: 'support-member-limit-state-check-only';
+    productionClaim: false;
+    method: 'closed-form-yield-buckling-slenderness-interaction';
+    status: FemSupportDesignStatus;
+    units: FemSupportDesignUnits;
+    member: FemSupportMemberProperties & {
+        effectiveLengthM: number;
+        radiusOfGyrationM: number;
+        slendernessRatio: number;
+    };
+    demand: FemSupportMemberDemand & {
+        factoredAxialCompressionDemandKn: number;
+        factoredBendingMomentDemandKnM: number;
+    };
+    factors: Required<FemSupportDesignFactors>;
+    capacities: {
+        nominalYieldCompressionCapacityKn: number;
+        nominalEulerBucklingCapacityKn: number;
+        designCompressionCapacityKn: number;
+        designFlexuralCapacityKnM?: number;
+    };
+    limitStates: FemSupportMemberLimitState[];
+    controllingLimitState: FemSupportMemberLimitState;
+    acceptanceBlockers: string[];
+    convergence: FemSupportMemberConvergenceMetadata;
+    review: FemSupportDesignReviewMetadata;
+    limitations: string[];
+    policy: FemConvergencePolicy;
+}
+export declare function validateFemSupportMemberDesignCheckInput(input: unknown): FemSupportMemberDesignInputValidation;
+export declare function runFemSupportMemberDesignCheck(input: FemSupportMemberDesignCheckInput): FemSupportMemberDesignCheckResult;
+//# sourceMappingURL=support-design.d.ts.map

package/dist/fem/support-design.d.ts.map

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

package/dist/fem/support-design.js

@@ -0,0 +1,380 @@
+const DEFAULT_SUPPORT_DESIGN_UNITS = {
+    length: 'm',
+    force: 'kN',
+    stress: 'MPa',
+    area: 'm2',
+    moment: 'kN-m',
+    momentOfInertia: 'm4',
+    sectionModulus: 'm3',
+    utilization: 'ratio',
+};
+const DEFAULT_SUPPORT_DESIGN_FACTORS = {
+    demandFactor: 1,
+    resistanceFactorCompression: 0.9,
+    resistanceFactorFlexure: 0.9,
+    maximumSlendernessRatio: 200,
+};
+const DEFAULT_SUPPORT_DESIGN_CONVERGENCE_POLICY = {
+    schemaVersion: 'fem-convergence-policy.v1',
+    residualTolerance: 1e-6,
+    forceBalanceTolerance: 1e-3,
+    porePressureMassBalanceTolerance: 1e-3,
+    maxIterations: 40,
+    minAcceptedSteps: 3,
+};
+function isRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isFinitePositive(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+function isFiniteNonNegative(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+function round(value, digits = 6) {
+    const scale = 10 ** digits;
+    return Math.round(value * scale) / scale;
+}
+function validatePolicy(policy, blockers) {
+    if (policy == null)
+        return;
+    if (!isRecord(policy)) {
+        blockers.push('policy.invalid');
+        return;
+    }
+    if (policy.schemaVersion !== 'fem-convergence-policy.v1') {
+        blockers.push('policy.schema-version.unsupported');
+    }
+    for (const field of [
+        'residualTolerance',
+        'forceBalanceTolerance',
+        'porePressureMassBalanceTolerance',
+    ]) {
+        if (!isFinitePositive(policy[field])) {
+            blockers.push(`policy.${field}.invalid`);
+        }
+    }
+    if (!Number.isInteger(policy.maxIterations) || policy.maxIterations <= 0) {
+        blockers.push('policy.maxIterations.invalid');
+    }
+    if (!Number.isInteger(policy.minAcceptedSteps) || policy.minAcceptedSteps <= 0) {
+        blockers.push('policy.minAcceptedSteps.invalid');
+    }
+    if (Number.isInteger(policy.maxIterations) &&
+        Number.isInteger(policy.minAcceptedSteps) &&
+        policy.minAcceptedSteps > policy.maxIterations) {
+        blockers.push('policy.minAcceptedSteps.exceeds-maxIterations');
+    }
+}
+function validateUnits(units, blockers) {
+    if (!isRecord(units)) {
+        blockers.push('units.missing');
+        return;
+    }
+    for (const [key, expected] of Object.entries(DEFAULT_SUPPORT_DESIGN_UNITS)) {
+        if (units[key] !== expected) {
+            blockers.push(`units.${key}.unsupported`);
+        }
+    }
+}
+function validateAssumptions(assumptions, blockers) {
+    if (!Array.isArray(assumptions) || assumptions.length === 0) {
+        blockers.push('review.assumptions.missing');
+        return;
+    }
+    assumptions.forEach((assumption, index) => {
+        if (!isRecord(assumption)) {
+            blockers.push(`review.assumptions.${index}.invalid`);
+            return;
+        }
+        for (const field of ['id', 'parameter', 'basis']) {
+            if (!isNonEmptyString(assumption[field])) {
+                blockers.push(`review.assumptions.${index}.${field}.missing`);
+            }
+        }
+        if (assumption.value == null || (typeof assumption.value === 'string' && !assumption.value.trim())) {
+            blockers.push(`review.assumptions.${index}.value.missing`);
+        }
+        if (assumption.confidence !== 'measured' &&
+            assumption.confidence !== 'inferred' &&
+            assumption.confidence !== 'review') {
+            blockers.push(`review.assumptions.${index}.confidence.invalid`);
+        }
+        if (typeof assumption.reviewRequired !== 'boolean') {
+            blockers.push(`review.assumptions.${index}.reviewRequired.invalid`);
+        }
+    });
+}
+export function validateFemSupportMemberDesignCheckInput(input) {
+    const blockerCodes = [];
+    const warnings = [];
+    if (!isRecord(input)) {
+        return {
+            schemaVersion: 'fem-support-member-design-input-validation.v1',
+            status: 'blocked',
+            blockerCodes: ['input.invalid'],
+            warnings,
+        };
+    }
+    if (input.schemaVersion !== 'fem-support-member-design-input.v1') {
+        blockerCodes.push('schema-version.unsupported');
+    }
+    validateUnits(input.units, blockerCodes);
+    validatePolicy(input.policy, blockerCodes);
+    const member = input.member;
+    if (!isRecord(member)) {
+        blockerCodes.push('member.missing');
+    }
+    else {
+        if (!isNonEmptyString(member.id))
+            blockerCodes.push('member.id.missing');
+        if (member.kind !== 'strut' && member.kind !== 'brace')
+            blockerCodes.push('member.kind.unsupported');
+        for (const field of [
+            'unbracedLengthM',
+            'effectiveLengthFactor',
+            'areaM2',
+            'weakAxisMomentOfInertiaM4',
+            'yieldStrengthMpa',
+            'elasticModulusMpa',
+        ]) {
+            if (!isFinitePositive(member[field]))
+                blockerCodes.push(`member.${field}.invalid`);
+        }
+        if (member.sectionModulusM3 != null && !isFinitePositive(member.sectionModulusM3)) {
+            blockerCodes.push('member.sectionModulusM3.invalid');
+        }
+    }
+    const demand = input.demand;
+    if (!isRecord(demand)) {
+        blockerCodes.push('demand.missing');
+    }
+    else {
+        if (!isFinitePositive(demand.axialCompressionDemandKn)) {
+            blockerCodes.push('demand.axialCompressionDemandKn.invalid');
+        }
+        if (demand.bendingMomentDemandKnM != null && !isFiniteNonNegative(demand.bendingMomentDemandKnM)) {
+            blockerCodes.push('demand.bendingMomentDemandKnM.invalid');
+        }
+        const source = demand.source;
+        if (!isRecord(source)) {
+            blockerCodes.push('demand.source.missing');
+        }
+        else {
+            if (source.source !== 'fem-result-envelope' &&
+                source.source !== 'support-reaction-screening' &&
+                source.source !== 'reviewed-hand-calculation') {
+                blockerCodes.push('demand.source.source.unsupported');
+            }
+            if (!isNonEmptyString(source.loadCombination))
+                blockerCodes.push('demand.source.loadCombination.missing');
+            if (!isNonEmptyString(source.description))
+                blockerCodes.push('demand.source.description.missing');
+            if (source.resultHashSha256 != null && !/^[a-f0-9]{64}$/i.test(String(source.resultHashSha256))) {
+                blockerCodes.push('demand.source.resultHashSha256.invalid');
+            }
+        }
+    }
+    const bendingDemand = isRecord(demand) && typeof demand.bendingMomentDemandKnM === 'number'
+        ? demand.bendingMomentDemandKnM
+        : 0;
+    if (bendingDemand > 0 && (!isRecord(member) || !isFinitePositive(member.sectionModulusM3))) {
+        blockerCodes.push('member.sectionModulusM3.required-for-bending');
+    }
+    const factors = input.factors;
+    if (factors != null) {
+        if (!isRecord(factors)) {
+            blockerCodes.push('factors.invalid');
+        }
+        else {
+            for (const field of [
+                'demandFactor',
+                'resistanceFactorCompression',
+                'resistanceFactorFlexure',
+                'maximumSlendernessRatio',
+            ]) {
+                if (factors[field] != null && !isFinitePositive(factors[field])) {
+                    blockerCodes.push(`factors.${field}.invalid`);
+                }
+            }
+            for (const field of ['resistanceFactorCompression', 'resistanceFactorFlexure']) {
+                if (typeof factors[field] === 'number' && factors[field] > 1) {
+                    blockerCodes.push(`factors.${field}.exceeds-one`);
+                }
+            }
+        }
+    }
+    const review = input.review;
+    if (!isRecord(review)) {
+        blockerCodes.push('review.missing');
+    }
+    else {
+        if (review.schemaVersion !== 'fem-support-design-review-metadata.v1') {
+            blockerCodes.push('review.schema-version.unsupported');
+        }
+        const reviewer = review.reviewer;
+        if (!isRecord(reviewer)) {
+            blockerCodes.push('review.reviewer.missing');
+        }
+        else {
+            if (!isNonEmptyString(reviewer.name))
+                blockerCodes.push('review.reviewer.name.missing');
+            if (!isNonEmptyString(reviewer.licenseId))
+                blockerCodes.push('review.reviewer.licenseId.missing');
+            if (!isNonEmptyString(reviewer.jurisdiction))
+                blockerCodes.push('review.reviewer.jurisdiction.missing');
+        }
+        if (!isNonEmptyString(review.reviewedAt) || Number.isNaN(Date.parse(review.reviewedAt))) {
+            blockerCodes.push('review.reviewedAt.invalid');
+        }
+        validateAssumptions(review.assumptions, blockerCodes);
+        if (!Array.isArray(review.limitations) || review.limitations.length === 0) {
+            blockerCodes.push('review.limitations.missing');
+        }
+        else {
+            review.limitations.forEach((limitation, index) => {
+                if (!isNonEmptyString(limitation)) {
+                    blockerCodes.push(`review.limitations.${index}.invalid`);
+                }
+            });
+        }
+    }
+    const uniqueBlockers = [...new Set(blockerCodes)];
+    return {
+        schemaVersion: 'fem-support-member-design-input-validation.v1',
+        status: uniqueBlockers.length === 0 ? 'accepted' : 'blocked',
+        blockerCodes: uniqueBlockers,
+        warnings,
+    };
+}
+function copyAssumption(assumption) {
+    return { ...assumption };
+}
+function copyReviewMetadata(review) {
+    return {
+        ...review,
+        reviewer: { ...review.reviewer },
+        assumptions: review.assumptions.map(copyAssumption),
+        limitations: [...review.limitations],
+    };
+}
+function buildLimitState(id, demand, capacity, unit) {
+    const utilization = demand / Math.max(capacity, 1e-12);
+    return {
+        id,
+        demand: round(demand, unit === 'ratio' ? 6 : 4),
+        capacity: round(capacity, unit === 'ratio' ? 6 : 4),
+        unit,
+        utilization: round(utilization, 6),
+        status: utilization <= 1 ? 'accepted' : 'blocked',
+    };
+}
+export function runFemSupportMemberDesignCheck(input) {
+    const inputValidation = validateFemSupportMemberDesignCheckInput(input);
+    if (inputValidation.status === 'blocked') {
+        throw new Error(`Invalid FEM support member design check input: ${inputValidation.blockerCodes.join(', ')}`);
+    }
+    const policy = input.policy ?? DEFAULT_SUPPORT_DESIGN_CONVERGENCE_POLICY;
+    const factors = {
+        ...DEFAULT_SUPPORT_DESIGN_FACTORS,
+        ...input.factors,
+    };
+    const effectiveLengthM = input.member.unbracedLengthM * input.member.effectiveLengthFactor;
+    const radiusOfGyrationM = Math.sqrt(input.member.weakAxisMomentOfInertiaM4 / input.member.areaM2);
+    const slendernessRatio = effectiveLengthM / radiusOfGyrationM;
+    const stressScaleKnPerM2 = 1000;
+    const nominalYieldCompressionCapacityKn = input.member.yieldStrengthMpa * stressScaleKnPerM2 * input.member.areaM2;
+    const nominalEulerBucklingCapacityKn = (Math.PI ** 2) *
+        input.member.elasticModulusMpa *
+        stressScaleKnPerM2 *
+        input.member.weakAxisMomentOfInertiaM4 /
+        (effectiveLengthM ** 2);
+    const designYieldCompressionCapacityKn = factors.resistanceFactorCompression * nominalYieldCompressionCapacityKn;
+    const designEulerBucklingCapacityKn = factors.resistanceFactorCompression * nominalEulerBucklingCapacityKn;
+    const designCompressionCapacityKn = Math.min(designYieldCompressionCapacityKn, designEulerBucklingCapacityKn);
+    const factoredAxialCompressionDemandKn = input.demand.axialCompressionDemandKn * factors.demandFactor;
+    const factoredBendingMomentDemandKnM = (input.demand.bendingMomentDemandKnM ?? 0) * factors.demandFactor;
+    const designFlexuralCapacityKnM = input.member.sectionModulusM3 != null
+        ? factors.resistanceFactorFlexure *
+            input.member.yieldStrengthMpa *
+            stressScaleKnPerM2 *
+            input.member.sectionModulusM3
+        : undefined;
+    const limitStates = [
+        buildLimitState('axial-yield', factoredAxialCompressionDemandKn, designYieldCompressionCapacityKn, 'kN'),
+        buildLimitState('euler-buckling', factoredAxialCompressionDemandKn, designEulerBucklingCapacityKn, 'kN'),
+        buildLimitState('slenderness', slendernessRatio, factors.maximumSlendernessRatio, 'ratio'),
+    ];
+    if (factoredBendingMomentDemandKnM > 0 && designFlexuralCapacityKnM != null) {
+        limitStates.push(buildLimitState('flexural-yield', factoredBendingMomentDemandKnM, designFlexuralCapacityKnM, 'kN-m'));
+    }
+    const combinedInteraction = (factoredAxialCompressionDemandKn / Math.max(designCompressionCapacityKn, 1e-12)) +
+        (factoredBendingMomentDemandKnM > 0 && designFlexuralCapacityKnM != null
+            ? factoredBendingMomentDemandKnM / Math.max(designFlexuralCapacityKnM, 1e-12)
+            : 0);
+    limitStates.push(buildLimitState('combined-axial-flexure', combinedInteraction, 1, 'ratio'));
+    const controllingLimitState = limitStates.reduce((controlling, current) => current.utilization > controlling.utilization ? current : controlling);
+    const acceptanceBlockers = limitStates
+        .filter((limitState) => limitState.status === 'blocked')
+        .map((limitState) => `support-member.${limitState.id}`);
+    const status = acceptanceBlockers.length === 0 ? 'accepted' : 'blocked';
+    const limitations = [
+        'Closed-form member check only; this does not run or approve a full nonlinear FEM model.',
+        'Demand must come from a separately reviewed FEM result envelope, screening calculation, or hand calculation.',
+        'Connections, local buckling, corrosion allowance, seismic detailing, construction tolerance, and jurisdiction-specific code clauses require separate review.',
+        ...input.review.limitations,
+    ];
+    return {
+        schemaVersion: 'fem-support-member-design-check.v1',
+        designScope: 'support-member-limit-state-check-only',
+        productionClaim: false,
+        method: 'closed-form-yield-buckling-slenderness-interaction',
+        status,
+        units: { ...input.units },
+        member: {
+            ...input.member,
+            effectiveLengthM: round(effectiveLengthM, 6),
+            radiusOfGyrationM: round(radiusOfGyrationM, 6),
+            slendernessRatio: round(slendernessRatio, 6),
+        },
+        demand: {
+            ...input.demand,
+            source: { ...input.demand.source },
+            factoredAxialCompressionDemandKn: round(factoredAxialCompressionDemandKn, 4),
+            factoredBendingMomentDemandKnM: round(factoredBendingMomentDemandKnM, 4),
+        },
+        factors: {
+            demandFactor: round(factors.demandFactor, 6),
+            resistanceFactorCompression: round(factors.resistanceFactorCompression, 6),
+            resistanceFactorFlexure: round(factors.resistanceFactorFlexure, 6),
+            maximumSlendernessRatio: round(factors.maximumSlendernessRatio, 6),
+        },
+        capacities: {
+            nominalYieldCompressionCapacityKn: round(nominalYieldCompressionCapacityKn, 4),
+            nominalEulerBucklingCapacityKn: round(nominalEulerBucklingCapacityKn, 4),
+            designCompressionCapacityKn: round(designCompressionCapacityKn, 4),
+            ...(designFlexuralCapacityKnM != null
+                ? { designFlexuralCapacityKnM: round(designFlexuralCapacityKnM, 4) }
+                : {}),
+        },
+        limitStates,
+        controllingLimitState,
+        acceptanceBlockers,
+        convergence: {
+            schemaVersion: 'fem-support-member-convergence.v1',
+            method: 'closed-form-limit-state-evaluation',
+            deterministic: true,
+            status: 'converged',
+            iterations: 1,
+            residualRatio: 0,
+            tolerance: policy.forceBalanceTolerance,
+        },
+        review: copyReviewMetadata(input.review),
+        limitations,
+        policy,
+    };
+}
+//# sourceMappingURL=support-design.js.map

package/dist/fem/support-design.js.map

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

package/dist/fem/types.d.ts

@@ -1,6 +1,6 @@
 import type { FemConvergencePolicy } from './engineering-evidence.js';
 export type FemObjective = 'foundation_settlement' | 'excavation_deformation' | 'tunnel_volume_loss_settlement' | 'staged_settlement_consolidation' | 'seepage_groundwater_coupling';
-export type FemAnalysisType = 'static_3d_small_strain' | 'static_3d_staged_elastic' | 'empirical_3d_settlement_surface' | 'time_dependent_1d_consolidation' | 'time_dependent_2d_biot_consolidation';
+export type FemAnalysisType = 'static_3d_small_strain' | 'static_3d_staged_elastic' | 'static_2d_plane_strain_drucker_prager' | 'empirical_3d_settlement_surface' | 'time_dependent_1d_consolidation' | 'time_dependent_2d_biot_consolidation';
 export type FemAssumptionConfidence = 'measured' | 'inferred' | 'review';
 export type FemFindingSeverity = 'info' | 'review' | 'blocker';
 export interface FemUnits {
@@ -247,6 +247,17 @@ export interface FemResultEnvelope {
     maxSolverResidualRatio?: number;
     maxYieldResidualRatio?: number;
     nonlinearPlasticStrain?: number;
+    planeStrainDofCount?: number;
+    planeStrainFreeDofCount?: number;
+    planeStrainConstrainedDofCount?: number;
+    plasticGaussPointCount?: number;
+    maxEquivalentPlasticStrain?: number;
+    maxEquivalentPlasticStrainIncrement?: number;
+    adaptiveAttemptCount?: number;
+    adaptiveAcceptedStepCount?: number;
+    adaptiveRejectedAttemptCount?: number;
+    adaptiveCutbackCount?: number;
+    adaptiveMaxCutbackDepth?: number;
     timeStepCount?: number;
     minPorePressureKpa?: number;
     maxPorePressureKpa?: number;
@@ -279,8 +290,23 @@ export interface FemResultPressureAudit {
     couplingRateSumM3PerS: number;
     darcyFlowRateSumM3PerS: number;
 }
+export interface FemResultBiotTransientAcceptance {
+    schemaVersion: 'fem-plane-strain-biot-transient-acceptance.v1';
+    accepted: boolean;
+    dissipationCheckMode: 'drained-dissipation' | 'prescribed-gradient-relaxation';
+    acceptedStepCount: number;
+    requiredStepCount: number;
+    maxResidualNormRatio: number;
+    maxMassBalanceErrorRatio: number;
+    maxPressureOvershootKpa: number;
+    monotonicAverageFreePressureDissipation: boolean;
+    monotonicAverageFreePressureDissipationRequired: boolean;
+    monotonicMaxPressureEnvelope: boolean;
+    finalPorePressureDissipationRatio: number;
+    blockerCodes: string[];
+}
 export type FemSolverConvergenceStatus = 'converged' | 'nonconverged';
-export type FemSolverTerminationReason = 'converged' | 'max_iterations' | 'force_residual_exceeded' | 'yield_residual_exceeded' | 'material_nonconvergence' | 'consolidation_nonconvergence';
+export type FemSolverTerminationReason = 'converged' | 'max_iterations' | 'linear_solver_nonconverged' | 'force_residual_exceeded' | 'yield_residual_exceeded' | 'material_nonconvergence' | 'consolidation_nonconvergence';
 export interface FemSolverResidualHistoryEntry {
     iteration: number;
     residualRatio: number;
@@ -288,6 +314,11 @@ export interface FemSolverResidualHistoryEntry {
     yieldResidualRatio?: number;
     residualTolerance?: number;
     maxFreeResidualKn?: number;
+    reactionBalanceRatio?: number;
+    maxYieldResidualRatio?: number;
+    yieldResidualTolerance?: number;
+    maxEquivalentPlasticStrain?: number;
+    maxEquivalentPlasticStrainIncrement?: number;
     axialStrain?: number;
     verticalStressKpa?: number;
     converged: boolean;
@@ -297,6 +328,9 @@ export interface FemSolverLoadStepConvergence {
     stageId?: string;
     stageLabel?: string;
     loadFactor?: number;
+    requestedLoadFactor?: number;
+    cutbackDepth?: number;
+    adaptiveCutback?: boolean;
     cumulativeLoadKpa?: number;
     iterations: number;
     residualRatio: number;
@@ -322,16 +356,45 @@ export interface FemSolverConvergenceReport {
     loadSteps: FemSolverLoadStepConvergence[];
     failure?: FemSolverConvergenceFailure;
 }
+export interface FemResultDruckerPragerAdaptiveLoadStepAttemptAudit {
+    attempt: number;
+    startLoadFactor: number;
+    targetLoadFactor: number;
+    requestedLoadFactor: number;
+    cutbackDepth: number;
+    accepted: boolean;
+    rollbackApplied: boolean;
+    terminationReason: FemSolverTerminationReason;
+    committedStateSignatureBefore: string;
+    committedStateSignatureAfter: string;
+}
+export interface FemResultDruckerPragerAdaptiveLoadSteppingAudit {
+    schemaVersion: 'fem-plane-strain-dp-adaptive-load-stepping.v1';
+    enabled: boolean;
+    strategy: 'explicit-only' | 'cutback-bisection';
+    requestedStepCount: number;
+    attemptedStepCount: number;
+    acceptedStepCount: number;
+    cutbackCount: number;
+    maxCutbackDepth: number;
+    minLoadFactorIncrement: number;
+    requestedLoadFactors: number[];
+    acceptedLoadFactors: number[];
+    attempts: FemResultDruckerPragerAdaptiveLoadStepAttemptAudit[];
+    blockerCodes: string[];
+}
+export type FemResultBackendId = 'builtin-elastic3d-demo' | 'builtin-staged-excavation-demo' | 'builtin-tunnel-volume-loss-demo' | 'builtin-staged-consolidation-1d' | 'builtin-nonlinear-column-v0' | 'builtin-biot-up-plane-strain-v0' | 'builtin-plane-strain-dp-adaptive-v0';
 export interface FemResultManifest {
     schemaVersion: 'fem-result-manifest.v0';
     caseId: string;
     title: string;
     generatedAt: string;
     backend: {
-        id: 'builtin-elastic3d-demo' | 'builtin-staged-excavation-demo' | 'builtin-tunnel-volume-loss-demo' | 'builtin-staged-consolidation-1d' | 'builtin-nonlinear-column-v0' | 'builtin-biot-up-plane-strain-v0';
+        id: FemResultBackendId;
         label: string;
         deterministic: true;
         version: string;
+        productionReady?: false;
     };
     analysisCase: FemAnalysisCase;
     validation: FemValidationSummary;
@@ -346,6 +409,8 @@ export interface FemResultManifest {
     };
     envelope: FemResultEnvelope;
     pressureAudit?: FemResultPressureAudit;
+    biotTransientAcceptance?: FemResultBiotTransientAcceptance;
+    adaptiveLoadStepping?: FemResultDruckerPragerAdaptiveLoadSteppingAudit;
     solverConvergence?: FemSolverConvergenceReport;
     visualization: FemVisualizationMesh;
     resultFields?: FemResultField[];