@geotechcli/core 0.4.54 → 0.4.56

package/dist/fem/demo.js

@@ -0,0 +1,274 @@
+import { validateFemAnalysisCase } from './validation.js';
+const DEFAULT_UNITS = {
+    length: 'm',
+    force: 'kN',
+    stress: 'kPa',
+    density: 'kN/m3',
+    displacement: 'mm',
+};
+function round(value, digits = 3) {
+    const factor = 10 ** digits;
+    return Math.round(value * factor) / factor;
+}
+function settlementColor(t) {
+    const stops = [
+        [43, 62, 154],
+        [47, 107, 205],
+        [56, 170, 210],
+        [80, 200, 120],
+        [235, 210, 75],
+        [220, 83, 44],
+        [170, 25, 55],
+    ];
+    const scaled = Math.min(Math.max(t, 0), 1) * (stops.length - 1);
+    const left = Math.floor(scaled);
+    const right = Math.min(left + 1, stops.length - 1);
+    const local = scaled - left;
+    return [0, 1, 2].map((index) => {
+        const value = stops[left][index] + (stops[right][index] - stops[left][index]) * local;
+        return round(value / 255, 4);
+    });
+}
+export function buildRaftDemoAnalysisCase(now = new Date('2026-05-16T00:00:00.000Z')) {
+    const assumptions = [
+        {
+            id: 'linear-elastic-screening',
+            parameter: 'soil constitutive behavior',
+            value: 'linear elastic, drained, small strain',
+            basis: 'Experimental offline demonstration for WebGL/FEM workflow validation.',
+            confidence: 'review',
+            reviewRequired: true,
+        },
+        {
+            id: 'poisson-ratio',
+            parameter: 'nu',
+            value: 0.3,
+            unit: '-',
+            basis: 'Typical preliminary drained elastic screening value.',
+            confidence: 'review',
+            reviewRequired: true,
+        },
+        {
+            id: 'groundwater-not-modelled',
+            parameter: 'groundwater',
+            value: 'not modelled',
+            basis: 'Phase 0 FEM demo excludes pore pressure and consolidation coupling.',
+            confidence: 'review',
+            reviewRequired: true,
+        },
+    ];
+    return {
+        schemaVersion: 'fem-analysis-case.v0',
+        caseId: 'raft-settlement-demo',
+        title: 'Experimental 3D FEM raft settlement demo',
+        createdBy: 'geotechcli-fem-demo',
+        createdAt: now.toISOString(),
+        experimental: true,
+        objective: 'foundation_settlement',
+        analysisType: 'static_3d_small_strain',
+        units: DEFAULT_UNITS,
+        geometry: {
+            domain: {
+                type: 'box',
+                lengthM: 24,
+                widthM: 24,
+                depthM: 12,
+            },
+            raft: {
+                type: 'raft',
+                lengthM: 8,
+                widthM: 8,
+                thicknessM: 0.6,
+                centerXM: 0,
+                centerYM: 0,
+            },
+        },
+        materials: [
+            {
+                id: 'soil-1',
+                name: 'Representative elastic soil',
+                model: 'linear_elastic',
+                elasticModulusKpa: 50000,
+                poissonRatio: 0.3,
+                unitWeightKnM3: 18,
+                evidenceRefs: [],
+                assumptions,
+            },
+        ],
+        loads: [
+            {
+                id: 'raft-pressure',
+                type: 'uniform_pressure',
+                target: 'raft',
+                pressureKpa: 150,
+                evidenceRefs: [],
+                assumptions: [
+                    {
+                        id: 'service-pressure',
+                        parameter: 'raft service pressure',
+                        value: 150,
+                        unit: 'kPa',
+                        basis: 'Representative load for the experimental demo.',
+                        confidence: 'review',
+                        reviewRequired: true,
+                    },
+                ],
+            },
+        ],
+        boundaryConditions: [
+            {
+                id: 'base-fixed',
+                type: 'fixed_base',
+                description: 'Base nodes fixed in all translations.',
+            },
+            {
+                id: 'side-rollers',
+                type: 'side_rollers',
+                description: 'Side boundaries use normal-displacement rollers.',
+            },
+        ],
+        mesh: {
+            elementType: 'hex8',
+            divisionsX: 12,
+            divisionsY: 12,
+            divisionsZ: 6,
+        },
+        groundwater: {
+            condition: 'not_modelled',
+            note: 'Groundwater and pore-pressure coupling are not included in this experimental demo.',
+            reviewRequired: true,
+        },
+        assumptions,
+        evidenceRefs: [],
+        limitations: [
+            'Experimental screening demo only; not a design model.',
+            'Linear elastic small-strain response only.',
+            'No plasticity, consolidation, pore-pressure coupling, or construction staging.',
+            'Settlement field is generated by a deterministic built-in elastic influence approximation for viewer and workflow validation.',
+        ],
+    };
+}
+function buildVisualizationMesh(caseFile, maxSettlementMm) {
+    const { domain, raft } = caseFile.geometry;
+    const nx = caseFile.mesh.divisionsX;
+    const ny = caseFile.mesh.divisionsY;
+    const base = [];
+    const disp = [];
+    const color = [];
+    const tri = [];
+    const edge = [];
+    const sigma = Math.max(raft.lengthM, raft.widthM) * 0.62;
+    for (let iy = 0; iy <= ny; iy += 1) {
+        const y = -domain.widthM / 2 + (domain.widthM * iy) / ny;
+        for (let ix = 0; ix <= nx; ix += 1) {
+            const x = -domain.lengthM / 2 + (domain.lengthM * ix) / nx;
+            const dx = x - raft.centerXM;
+            const dy = y - raft.centerYM;
+            const radial = Math.sqrt(dx * dx + dy * dy);
+            const edgeBoost = Math.abs(dx) <= raft.lengthM / 2 && Math.abs(dy) <= raft.widthM / 2 ? 1 : 0.88;
+            const settlementMm = maxSettlementMm * Math.exp(-(radial * radial) / (2 * sigma * sigma)) * edgeBoost;
+            const normalized = settlementMm / maxSettlementMm;
+            const [r, g, b] = settlementColor(normalized);
+            base.push(round(x), round(y), 0);
+            disp.push(0, 0, round(-settlementMm / 1000, 6));
+            color.push(r, g, b);
+        }
+    }
+    const idx = (ix, iy) => iy * (nx + 1) + ix;
+    for (let iy = 0; iy < ny; iy += 1) {
+        for (let ix = 0; ix < nx; ix += 1) {
+            const a = idx(ix, iy);
+            const b = idx(ix + 1, iy);
+            const c = idx(ix + 1, iy + 1);
+            const d = idx(ix, iy + 1);
+            tri.push(a, b, c, a, c, d);
+        }
+    }
+    for (let iy = 0; iy <= ny; iy += 1) {
+        for (let ix = 0; ix < nx; ix += 1) {
+            edge.push(idx(ix, iy), idx(ix + 1, iy));
+        }
+    }
+    for (let ix = 0; ix <= nx; ix += 1) {
+        for (let iy = 0; iy < ny; iy += 1) {
+            edge.push(idx(ix, iy), idx(ix, iy + 1));
+        }
+    }
+    const z = 0.03;
+    const halfL = raft.lengthM / 2;
+    const halfW = raft.widthM / 2;
+    return {
+        base,
+        disp,
+        color,
+        tri,
+        edge,
+        outlineBase: [
+            -halfL, -halfW, z,
+            halfL, -halfW, z,
+            halfL, halfW, z,
+            -halfL, halfW, z,
+        ],
+        outlineDisp: new Array(12).fill(0),
+        outlineIdx: [0, 1, 1, 2, 2, 3, 3, 0],
+    };
+}
+export function runBuiltinElasticRaftDemo(caseFile = buildRaftDemoAnalysisCase()) {
+    const validation = validateFemAnalysisCase(caseFile);
+    const material = caseFile.materials[0];
+    const load = caseFile.loads[0];
+    if (!material || !load) {
+        throw new Error('Raft demo requires one material and one pressure load.');
+    }
+    if (validation.status === 'blocked') {
+        throw new Error(`FEM case is blocked: ${validation.findings.map((item) => item.message).join('; ')}`);
+    }
+    const raft = caseFile.geometry.raft;
+    const loadedArea = raft.lengthM * raft.widthM;
+    const totalLoadKn = load.pressureKpa * loadedArea;
+    const stiffnessSettlementM = (load.pressureKpa * Math.min(raft.lengthM, raft.widthM) * (1 - material.poissonRatio ** 2)) /
+        material.elasticModulusKpa;
+    const maxSettlementMm = round(stiffnessSettlementM * 1000 * 0.82, 3);
+    const visualization = buildVisualizationMesh(caseFile, maxSettlementMm);
+    const surfaceSettlements = visualization.disp
+        .filter((_, index) => index % 3 === 2)
+        .map((value) => Math.abs(value * 1000));
+    const minSettlementMm = round(Math.min(...surfaceSettlements), 3);
+    return {
+        schemaVersion: 'fem-result-manifest.v0',
+        caseId: caseFile.caseId,
+        title: caseFile.title,
+        generatedAt: new Date().toISOString(),
+        backend: {
+            id: 'builtin-elastic3d-demo',
+            label: 'Built-in experimental elastic 3D screening demo',
+            deterministic: true,
+            version: '0.1.0',
+        },
+        analysisCase: caseFile,
+        validation,
+        mesh: {
+            nodes: (caseFile.mesh.divisionsX + 1) * (caseFile.mesh.divisionsY + 1) * (caseFile.mesh.divisionsZ + 1),
+            elements: caseFile.mesh.divisionsX * caseFile.mesh.divisionsY * caseFile.mesh.divisionsZ,
+            elementType: caseFile.mesh.elementType,
+            divisions: [caseFile.mesh.divisionsX, caseFile.mesh.divisionsY, caseFile.mesh.divisionsZ],
+            visualizationNodes: visualization.base.length / 3,
+            visualizationTriangles: visualization.tri.length / 3,
+            visualizationEdges: visualization.edge.length / 2,
+        },
+        envelope: {
+            maxSettlementMm,
+            minSettlementMm,
+            totalLoadKn: round(totalLoadKn, 3),
+            reactionKn: round(totalLoadKn, 3),
+            reactionBalanceRatio: 1,
+        },
+        visualization,
+        assumptions: [
+            ...caseFile.assumptions,
+            ...caseFile.loads.flatMap((item) => item.assumptions),
+        ],
+        limitations: caseFile.limitations,
+    };
+}
+//# sourceMappingURL=demo.js.map

package/dist/fem/demo.js.map

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

package/dist/fem/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export { buildRaftDemoAnalysisCase, runBuiltinElasticRaftDemo } from './demo.js';
+export { getFemCapability, listFemCapabilities, prepareFemAnalysisCaseDraft, type FemAnalysisCaseDraft, type FemCapability, type FemCapabilityStatus, type FemRouteObjective, } from './routing.js';
+export { validateFemAnalysisCase, validateFemResultManifest } from './validation.js';
+export { renderFemWebglHtml } from './webgl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fem/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/fem/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export { buildRaftDemoAnalysisCase, runBuiltinElasticRaftDemo } from './demo.js';
+export { getFemCapability, listFemCapabilities, prepareFemAnalysisCaseDraft, } from './routing.js';
+export { validateFemAnalysisCase, validateFemResultManifest } from './validation.js';
+export { renderFemWebglHtml } from './webgl.js';
+//# sourceMappingURL=index.js.map

package/dist/fem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fem/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,GAK5B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/fem/routing.d.ts

@@ -0,0 +1,62 @@
+import type { FemAnalysisCase, FemAssumption, FemEvidenceRef, FemValidationSummary } from './types.js';
+export type FemRouteObjective = 'foundation-settlement' | 'excavation-deformation' | 'shaft-deformation' | 'tunnel-volume-loss-settlement' | 'pile-group-elastic-interaction';
+export type FemCapabilityStatus = 'implemented-demo' | 'contract-draft' | 'planned';
+export interface FemCapability {
+    objective: FemRouteObjective;
+    label: string;
+    status: FemCapabilityStatus;
+    analysisType: string;
+    deterministicBackend: string | null;
+    description: string;
+    requiredEvidence: string[];
+    requiredUserInputs: string[];
+    visualizationFields: string[];
+    reviewGates: string[];
+    limitations: string[];
+    command?: string;
+}
+export interface PrepareFemAnalysisCaseDraftInput {
+    objective: FemRouteObjective;
+    useDemoDefaults?: boolean;
+    geometry?: {
+        raftLengthM?: number;
+        raftWidthM?: number;
+        raftThicknessM?: number;
+        domainLengthM?: number;
+        domainWidthM?: number;
+        domainDepthM?: number;
+    };
+    load?: {
+        pressureKpa?: number;
+    };
+    material?: {
+        elasticModulusKpa?: number;
+        poissonRatio?: number;
+        unitWeightKnM3?: number;
+    };
+    groundwater?: {
+        condition?: 'not_modelled' | 'below_domain' | 'specified';
+        depthM?: number;
+        note?: string;
+    };
+    evidenceRefs?: FemEvidenceRef[];
+}
+export interface FemAnalysisCaseDraft {
+    schemaVersion: 'fem-analysis-case-draft.v1';
+    objective: FemRouteObjective;
+    capability: FemCapability;
+    implemented: boolean;
+    canAutoProceed: false;
+    recommendedAction: 'run-experimental-demo' | 'collect-inputs' | 'contract-only';
+    missingUserInputs: string[];
+    assumptions: FemAssumption[];
+    reviewGates: string[];
+    evidenceRefs: FemEvidenceRef[];
+    analysisCase?: FemAnalysisCase;
+    validation?: FemValidationSummary;
+    recommendedCommand?: string;
+}
+export declare function listFemCapabilities(objective?: FemRouteObjective): FemCapability[];
+export declare function getFemCapability(objective: FemRouteObjective): FemCapability | undefined;
+export declare function prepareFemAnalysisCaseDraft(input: PrepareFemAnalysisCaseDraftInput): FemAnalysisCaseDraft;
+//# sourceMappingURL=routing.d.ts.map

package/dist/fem/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/fem/routing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,wBAAwB,GACxB,mBAAmB,GACnB,+BAA+B,GAC/B,gCAAgC,CAAC;AAErC,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,iBAAiB,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;QAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,4BAA4B,CAAC;IAC5C,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC;IACtB,iBAAiB,EAAE,uBAAuB,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAChF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAiFD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAElF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAExF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gCAAgC,GAAG,oBAAoB,CAsHzG"}

package/dist/fem/routing.js

@@ -0,0 +1,202 @@
+import { buildRaftDemoAnalysisCase, } from './demo.js';
+import { validateFemAnalysisCase } from './validation.js';
+const CAPABILITIES = [
+    {
+        objective: 'foundation-settlement',
+        label: 'Foundation / raft settlement preview',
+        status: 'implemented-demo',
+        analysisType: 'static_3d_small_strain',
+        deterministicBackend: 'builtin-elastic3d-demo',
+        description: 'Experimental deterministic 3D elastic settlement preview for a uniformly loaded raft.',
+        requiredEvidence: ['GroundModel strata', 'elastic modulus or SPT/lab correlation basis', 'unit weight', 'groundwater assumption'],
+        requiredUserInputs: ['raft length', 'raft width', 'service pressure', 'foundation level / embedment'],
+        visualizationFields: ['vertical displacement', 'settlement basin', 'mesh wireframe', 'load patch'],
+        reviewGates: ['experimental-only', 'linear-elastic-only', 'groundwater-not-coupled', 'not-design-calculation'],
+        limitations: ['No plasticity, consolidation, construction staging, or pore pressure coupling.'],
+        command: 'geotech fem demo raft --experimental',
+    },
+    {
+        objective: 'excavation-deformation',
+        label: 'Staged excavation deformation preview',
+        status: 'contract-draft',
+        analysisType: 'static_3d_staged_elastic',
+        deterministicBackend: null,
+        description: 'Planned staged excavation preview for settlement trough, wall deflection proxy, and support reaction review.',
+        requiredEvidence: ['stratigraphy', 'groundwater condition', 'wall geometry', 'support levels', 'elastic stiffness basis'],
+        requiredUserInputs: ['excavation length', 'excavation width', 'final depth', 'stage depths', 'wall/support assumptions'],
+        visualizationFields: ['surface settlement', 'horizontal displacement', 'wall deflection proxy', 'stage slider', 'support overlays'],
+        reviewGates: ['contract-only', 'unsupported-wall-design', 'groundwater-coupling-required-review', 'not-basal-heave-verification'],
+        limitations: ['No wall design, basal heave design, seepage, consolidation, or nonlinear soil response.'],
+    },
+    {
+        objective: 'shaft-deformation',
+        label: 'Shaft / pit deformation preview',
+        status: 'planned',
+        analysisType: 'static_3d_staged_elastic',
+        deterministicBackend: null,
+        description: 'Planned circular or polygonal shaft deformation preview using the staged excavation contract.',
+        requiredEvidence: ['shaft geometry', 'stratigraphy', 'groundwater condition', 'support assumptions'],
+        requiredUserInputs: ['shaft diameter/shape', 'final depth', 'support sequence', 'groundwater handling'],
+        visualizationFields: ['radial ground movement', 'surface settlement', 'support reaction proxy'],
+        reviewGates: ['planned-only', 'not-design-calculation'],
+        limitations: ['No production solver or code acceptance check is available yet.'],
+    },
+    {
+        objective: 'tunnel-volume-loss-settlement',
+        label: 'Tunnel volume-loss settlement preview',
+        status: 'planned',
+        analysisType: 'empirical_3d_settlement_surface',
+        deterministicBackend: null,
+        description: 'Planned deterministic 3D settlement surface from prescribed tunnel volume loss.',
+        requiredEvidence: ['tunnel geometry', 'cover depth', 'ground class', 'volume-loss assumption'],
+        requiredUserInputs: ['diameter', 'axis depth', 'alignment', 'volume loss', 'trough width parameter'],
+        visualizationFields: ['settlement trough', 'building influence corridor', 'alignment overlay'],
+        reviewGates: ['planned-only', 'volume-loss-assumption-review', 'not-fem-solver'],
+        limitations: ['Empirical preview only; not a tunnel lining or ground loss design model.'],
+    },
+    {
+        objective: 'pile-group-elastic-interaction',
+        label: 'Pile group elastic interaction preview',
+        status: 'planned',
+        analysisType: 'static_3d_soil_structure_screening',
+        deterministicBackend: null,
+        description: 'Planned pile group displacement and interaction preview after pile/soil spring contracts are stable.',
+        requiredEvidence: ['pile layout', 'pile geometry', 'stratigraphy', 'stiffness/capacity basis'],
+        requiredUserInputs: ['pile diameter', 'pile length', 'pile spacing', 'load case', 'pile head condition'],
+        visualizationFields: ['pile head settlement', 'interaction contours', 'load share proxy'],
+        reviewGates: ['planned-only', 'pile-soil-interface-review', 'not-design-calculation'],
+        limitations: ['No pile group solver or code acceptance check is available yet.'],
+    },
+];
+function finitePositive(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+function requirePositive(value, label, missing) {
+    if (finitePositive(value))
+        return value;
+    missing.push(label);
+    return undefined;
+}
+export function listFemCapabilities(objective) {
+    return CAPABILITIES.filter((capability) => objective == null || capability.objective === objective);
+}
+export function getFemCapability(objective) {
+    return CAPABILITIES.find((capability) => capability.objective === objective);
+}
+export function prepareFemAnalysisCaseDraft(input) {
+    const capability = getFemCapability(input.objective);
+    if (!capability) {
+        return {
+            schemaVersion: 'fem-analysis-case-draft.v1',
+            objective: input.objective,
+            capability: {
+                objective: input.objective,
+                label: 'Unknown FEM route',
+                status: 'planned',
+                analysisType: 'unknown',
+                deterministicBackend: null,
+                description: 'The requested FEM route is not registered in geotechCLI.',
+                requiredEvidence: [],
+                requiredUserInputs: [],
+                visualizationFields: [],
+                reviewGates: ['unknown-fem-route'],
+                limitations: ['No FEM contract exists for this route.'],
+            },
+            implemented: false,
+            canAutoProceed: false,
+            recommendedAction: 'contract-only',
+            missingUserInputs: ['supported FEM objective'],
+            assumptions: [],
+            reviewGates: ['unknown-fem-route'],
+            evidenceRefs: input.evidenceRefs ?? [],
+        };
+    }
+    if (capability.objective !== 'foundation-settlement') {
+        return {
+            schemaVersion: 'fem-analysis-case-draft.v1',
+            objective: capability.objective,
+            capability,
+            implemented: false,
+            canAutoProceed: false,
+            recommendedAction: 'contract-only',
+            missingUserInputs: capability.requiredUserInputs,
+            assumptions: [],
+            reviewGates: capability.reviewGates,
+            evidenceRefs: input.evidenceRefs ?? [],
+        };
+    }
+    const missing = [];
+    const useDemoDefaults = input.useDemoDefaults === true;
+    const raftLengthM = input.geometry?.raftLengthM ?? (useDemoDefaults ? 8 : undefined);
+    const raftWidthM = input.geometry?.raftWidthM ?? (useDemoDefaults ? 8 : undefined);
+    const pressureKpa = input.load?.pressureKpa ?? (useDemoDefaults ? 150 : undefined);
+    const checkedRaftLengthM = requirePositive(raftLengthM, 'raft length', missing);
+    const checkedRaftWidthM = requirePositive(raftWidthM, 'raft width', missing);
+    const checkedPressureKpa = requirePositive(pressureKpa, 'service pressure', missing);
+    if (!checkedRaftLengthM || !checkedRaftWidthM || !checkedPressureKpa) {
+        return {
+            schemaVersion: 'fem-analysis-case-draft.v1',
+            objective: capability.objective,
+            capability,
+            implemented: true,
+            canAutoProceed: false,
+            recommendedAction: 'collect-inputs',
+            missingUserInputs: missing,
+            assumptions: [],
+            reviewGates: ['missing-user-inputs', ...capability.reviewGates],
+            evidenceRefs: input.evidenceRefs ?? [],
+            recommendedCommand: capability.command,
+        };
+    }
+    const analysisCase = buildRaftDemoAnalysisCase();
+    analysisCase.caseId = 'raft-settlement-draft';
+    analysisCase.title = 'Experimental 3D FEM raft settlement draft';
+    analysisCase.createdBy = 'geotechcli-fem-routing';
+    analysisCase.geometry.raft.lengthM = checkedRaftLengthM;
+    analysisCase.geometry.raft.widthM = checkedRaftWidthM;
+    analysisCase.geometry.raft.thicknessM = input.geometry?.raftThicknessM ?? analysisCase.geometry.raft.thicknessM;
+    analysisCase.geometry.domain.lengthM = input.geometry?.domainLengthM ?? Math.max(checkedRaftLengthM * 3, analysisCase.geometry.domain.lengthM);
+    analysisCase.geometry.domain.widthM = input.geometry?.domainWidthM ?? Math.max(checkedRaftWidthM * 3, analysisCase.geometry.domain.widthM);
+    analysisCase.geometry.domain.depthM = input.geometry?.domainDepthM ?? Math.max(checkedRaftLengthM, checkedRaftWidthM, analysisCase.geometry.domain.depthM);
+    analysisCase.loads[0].pressureKpa = checkedPressureKpa;
+    analysisCase.evidenceRefs = input.evidenceRefs ?? [];
+    analysisCase.materials[0].evidenceRefs = input.evidenceRefs ?? [];
+    if (finitePositive(input.material?.elasticModulusKpa))
+        analysisCase.materials[0].elasticModulusKpa = input.material.elasticModulusKpa;
+    if (typeof input.material?.poissonRatio === 'number')
+        analysisCase.materials[0].poissonRatio = input.material.poissonRatio;
+    if (finitePositive(input.material?.unitWeightKnM3))
+        analysisCase.materials[0].unitWeightKnM3 = input.material.unitWeightKnM3;
+    if (input.groundwater?.condition) {
+        analysisCase.groundwater.condition = input.groundwater.condition;
+    }
+    if (typeof input.groundwater?.depthM === 'number') {
+        analysisCase.groundwater.depthM = input.groundwater.depthM;
+    }
+    if (input.groundwater?.note) {
+        analysisCase.groundwater.note = input.groundwater.note;
+    }
+    const validation = validateFemAnalysisCase(analysisCase);
+    const reviewGates = [
+        ...capability.reviewGates,
+        ...validation.findings
+            .filter((finding) => finding.severity !== 'info')
+            .map((finding) => finding.code),
+    ];
+    return {
+        schemaVersion: 'fem-analysis-case-draft.v1',
+        objective: capability.objective,
+        capability,
+        implemented: true,
+        canAutoProceed: false,
+        recommendedAction: 'run-experimental-demo',
+        missingUserInputs: [],
+        assumptions: analysisCase.assumptions,
+        reviewGates: [...new Set(reviewGates)],
+        evidenceRefs: analysisCase.evidenceRefs,
+        analysisCase,
+        validation,
+        recommendedCommand: capability.command,
+    };
+}
+//# sourceMappingURL=routing.js.map

package/dist/fem/routing.js.map

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