Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

15.4 KB
Raw Blame
{
  "version": "Preview 1 feature freeze",
  "commit": "736a8e69b013afac15a046939a98fa1a26bd1bd0",
  "branch": "master",
  "generatedAt": "2026-08-07",
  "packageVersion": null,
  "frontendPackageVersion": "0.0.0",
  "language": {
    "canonicalSyntaxVersion": "Firmament V2 canonical grammar X1",
    "root": "Model Name { Units: mm }",
    "declarations": ["Model", "Units", "Box", "Cylinder", "RoundedBox", "Frustum", "Concept", "Concept Struct", "Struct", "Construction Plane", "Concept Path", "Profile", "Compose", "Modify", "Hole<Shaft>", "Hole<Counterbore>", "Hole<Countersink>", "Slot<Capsule>", "Slot<RoundedRectangle>", "EdgeFinish", "Selection", "Record", "Static", "Template", "Pattern", "Match", "Require", "Assert Volume", "Pmi", "Datum", "InlineStep", "Recognize", "Replace"],
    "canonicalConventions": ["PascalCase declarations and fields", "typed Point2/Point3 and Vector2/Vector3", "mm dimensions and deg angles", "source-bound semantic selection"],
    "compatibilitySyntax": [
      {"form":"lowercase model/pmi and phase-style source", "status":"DeprecatedCompatibilityOnly"},
      {"form":"solid bindings and face-local On holes", "status":"RequiredForPreview1Compatibility"},
      {"form":"bracket point literals and PMI Dimension", "status":"DeprecatedCompatibilityOnly"},
      {"form":"lowercase InlineStep/recognize/replace", "status":"DeprecatedCompatibilityOnly"},
      {"form":"Solid, Let, Fill, Manufacturing, Feature, Expose canonical-root vocabulary", "status":"InternalFixtureOnly"}
    ]
  },
  "features": [
    {"id":"primitives", "status":"Supported", "scope":"Exact Box, Cylinder, RoundedBox, Frustum.", "fixturePaths":["fixtures/Canonical/Basics/box.firmament", "fixtures/Canonical/Basics/cylinder.firmament", "fixtures/Canonical/Primitives/rounded-box.firmament", "fixtures/Canonical/Primitives/frustum.firmament"], "diagnostics":["firmament-v2-canonical-primitive-malformed"]},
    {"id":"concept-struct-construction-plane", "status":"SupportedBounded", "scope":"Concept/Struct semantics and immutable traced frames; Box shaft ThroughAll on admitted signed-permutation frame.", "fixturePaths":["fixtures/Regression/Hole/valid/construction-plane-through-hole.firmament"], "diagnostics":["HoleConstructionPlaneHostUnsupported", "HoleConstructionPlaneOrientationUnsupported", "HoleConstructionPlaneExtentUnsupported"]},
    {"id":"concept-path-profile-compose", "status":"SupportedBounded", "scope":"Named line/arc paths normalize to ordinary resolved Profiles for Extrude and Compose. The bounded path vocabulary remains ordered Line, Arc, and Close geometry.", "fixturePaths":["fixtures/Canonical/Profiles/closed-loop-profile.firmament", "fixtures/Regression/CanonicalGeometry/concept-path-low-level-mixed.firmament", "fixtures/Regression/CanonicalGeometry/concept-path-inner-cutout.firmament", "fixtures/Regression/CanonicalGeometry/concept-path-compose-profile.firmament"], "diagnostics":["concept-path-open-profile", "concept-path-wrong-winding", "concept-path-zero-radius-arc", "profile-path-missing", "compose-operation-unresolved-profile"]},
    {"id":"hole-shaft", "status":"SupportedBounded", "scope":"Face-local ThroughAll and documented blind/drill-point forms; Pattern generation and bounded construction-plane route.", "fixturePaths":["fixtures/Canonical/Features/Holes/through-hole.firmament", "fixtures/Regression/Hole/valid/feature-v2-shaft-hole-blind-step-verified.valid.firmfixture", "fixtures/Regression/Hole/valid/construction-plane-through-hole.firmament"], "diagnostics":["HoleConstructionPlaneExtentUnsupported", "hole-x4-unknown"]},
    {"id":"hole-counterbore", "status":"SupportedBounded", "scope":"Required counterbore fields; primitive and +Z ThroughAll disjoint Profile/Compose host.", "fixturePaths":["fixtures/Regression/CanonicalGeometry/counterbore-hole.firmament", "fixtures/Canonical/PMI/counterbore-shaft-diameter.firmament"], "diagnostics":["hole-x4-bad-counterbore", "ProfileBoundaryChamferIntersectsCounterbore"]},
    {"id":"hole-countersink", "status":"SupportedBounded", "scope":"Required diameter and degree-angle fields on admitted simple host.", "fixturePaths":["fixtures/Regression/CanonicalGeometry/countersink-hole.firmament", "fixtures/Regression/Hole/valid/feature-v2-countersink-step-verified.valid.firmfixture"], "diagnostics":["firmament-v2-canonical-modify-malformed"]},
    {"id":"slots", "status":"SupportedBounded", "scope":"Capsule/RoundedRectangle ThroughAll slots in admitted Compose; RoundedRectangle requires CornerRadius.", "fixturePaths":["fixtures/Canonical/Features/Slots/straight-slot.firmament", "fixtures/Canonical/Features/Slots/rounded-rectangle-opening.firmament"], "diagnostics":["firmament-v2-canonical-modify-malformed"]},
    {"id":"selection", "status":"SupportedBounded", "scope":"Named, source-grounded Profile/Hole/Slot selectors only.", "fixturePaths":["fixtures/Canonical/Features/EdgeFinish/semantic-selection-chamfer.firmament"], "diagnostics":["firmament-v2-selection-malformed", "firmament-v2-selection-unknown-source", "firmament-v2-selection-result-kind-invalid"]},
    {"id":"chamfer", "status":"SupportedBounded", "scope":"Primitive and source-bound Profile Top/Bottom segment, chain, whole-loop; mixed line/arc exact Plane/Cone shell.", "fixturePaths":["fixtures/Canonical/Features/EdgeFinish/boundary-chamfer.firmament", "fixtures/Regression/CanonicalGeometry/profile-chamfer-mixed-convex-reflex-loop-top.firmament", "fixtures/Regression/CanonicalGeometry/profile-edgefinish-chimera-chamfer.firmament"], "stepArtifacts":["testdata/step242/golden/firmament-v1/profile-edgefinish-chimera-chamfer.step"], "diagnostics":["ProfileBoundaryChamferConvexArcRadiusTooSmall", "ProfileBoundaryChamferIntersectsShaft", "ProfileBoundaryChamferIntersectsCounterbore"]},
    {"id":"fillet-straight-and-junction", "status":"SupportedBounded", "scope":"Single finite straight edge and two adjacent straight convex/reflex 90-degree junctions; Top/Bottom; ExactRolling default.", "fixturePaths":["fixtures/Canonical/Features/EdgeFinish/single-edge-fillet.firmament", "fixtures/Regression/CanonicalGeometry/profile-fillet-convex-two-segment-top.firmament", "fixtures/Regression/CanonicalGeometry/profile-fillet-reflex-two-segment-top.firmament", "fixtures/Regression/CanonicalGeometry/profile-fillet-reflex-two-segment-sphere-seam-compatibility.firmament"], "stepArtifacts":["testdata/step242/golden/firmament-v1/profile-fillet-convex-two-segment-top.step", "testdata/step242/golden/firmament-v1/profile-fillet-reflex-two-segment-top.step"], "diagnostics":["ProfileBoundaryFilletConvexArcSpindleUnsupported", "ProfileBoundaryFilletComposeUnsupported"]},
    {"id":"fillet-mixed-whole-loop", "status":"Experimental", "scope":"Seven-station line/arc exact shell builds/reimports, but curved-trim mass tolerance is not release-tight.", "fixturePaths":["fixtures/Regression/CanonicalGeometry/profile-edgefinish-chimera-fillet.firmament", "fixtures/Regression/CanonicalGeometry/profile-edgefinish-chimera-reflex-sphere-compat.firmament"], "stepArtifacts":["testdata/step242/golden/firmament-v1/profile-edgefinish-chimera-fillet.step", "testdata/step242/golden/firmament-v1/profile-edgefinish-chimera-reflex-sphere-compat.step"], "knownLimits":["Assert Volume certified error bounds approximately 41239 mm^3 and 41263 mm^3"]},
    {"id":"record-static-template-pattern", "status":"SupportedBounded", "scope":"Compile-time typed records/static arrays, one typed template parameter, deterministic bounded Pattern expansion to Hole/Slot; direct indexed Profile template invocation.", "fixturePaths":["fixtures/Canonical/Patterns/record-array-hole-pattern.firmament", "fixtures/Canonical/Patterns/record-array-slot-pattern.firmament", "fixtures/Canonical/Templates/record-array-profile-family.firmament"], "diagnostics":["firmament-v2-static-pattern-body-invalid"]},
    {"id":"match", "status":"Experimental", "scope":"Bounded template-expansion arm selection only; no runtime control flow.", "fixturePaths":["fixtures/Regression/DemoRegression/template-m4b-standard.firmament"], "knownLimits":["No general runtime programming or arbitrary expression evaluation"]},
    {"id":"require", "status":"SupportedBounded", "scope":"Static comparisons plus named semantic hole-diameter constraints used by projected PMI.", "fixturePaths":["fixtures/Canonical/Patterns/record-array-hole-pattern.firmament", "fixtures/Regression/CanonicalGeometry/pmi-projected-hole-diameter.firmament"], "diagnostics":["firmament-v2-pmi-projection-unknown-require"]},
    {"id":"assert-volume", "status":"SupportedBounded", "scope":"Literal Expected/Tolerance mm^3, semantic body target, optional Note; build reimports STEP and emits JSON result.", "fixturePaths":["fixtures/Canonical/Basics/box.firmament", "fixtures/Canonical/Features/EdgeFinish/single-edge-fillet.firmament"], "diagnostics":["firmament-v2-assert-volume-failed", "firmament-v2-assert-volume-measurement-unavailable"]},
    {"id":"pmi-manual-and-projected", "status":"SupportedBounded", "scope":"Datum and HoleDiameter; explicit validated Require From/As projection; no inferred projection.", "fixturePaths":["fixtures/Canonical/PMI/hole-diameter-and-datum.firmament", "fixtures/Regression/CanonicalGeometry/pmi-projected-hole-diameter.firmament", "fixtures/Regression/CanonicalGeometry/pmi-manual-vs-projected-equivalence.firmament"], "stepArtifacts":["artifacts/release/interop/pmi-projected-hole.step"], "diagnostics":["firmament-v2-pmi-projected-field-must-not-override-source-constraint", "firmament-v2-pmi-projection-unknown-require"]},
    {"id":"inline-step-recognize-replace", "status":"SupportedBounded", "scope":"Canonical Aetheris AP242 import, HoleShaft/DatumPlane recognition, sequential face IDs, ThroughAll shaft replacement only.", "fixturePaths":["fixtures/Canonical/Integration/inline-step-recognize-replace.firmament"], "diagnostics":["firmament-inline-step-requires-aetheris-canonical-step"]}
  ],
  "edgeFinish": {
    "chamferMatrix":{"sharpConvex":"Supported", "sharpReflex":"Supported", "roundedConvex":"SupportedBounded", "roundedReflex":"SupportedBounded", "mixedLineArcWholeLoop":"Supported", "topBottom":"Supported", "wholeLoopChainSegment":"SupportedBounded", "conicalSourceArc":"Supported", "coneApex":"SupportedBounded", "nurbsFallback":"Unsupported"},
    "filletMatrix":{"singleStraightEdge":"Supported", "convexTwoSegment":"Supported", "reflexTwoSegmentExactRolling":"Supported", "sphereSeamCompatibility":"SupportedWithExplicitCompatibilityPolicy", "roundedSourcePolicy":"Experimental", "chainBinding":"SupportedBounded", "wholeLoopBinding":"Experimental", "wholeLoopMaterialization":"Experimental"},
    "compatibilityPolicies":{"ExactRolling":{"default":true,"geometry":"exact horn-torus reflex rolling"}, "SphereSeamCompatibility":{"optIn":true,"geometry":"distinct sphere-seam topology for importer interoperability"}},
    "invalidPolicies":[
      {"id":"convex-small-chamfer", "status":"Invalid", "fixturePath":"fixtures/Invalid/Geometry/profile-edgefinish-convex-small-chamfer-invalid.firmament", "diagnostic":"ProfileBoundaryChamferConvexArcRadiusTooSmall"},
      {"id":"convex-small-fillet", "status":"Invalid", "fixturePath":"fixtures/Invalid/Geometry/profile-edgefinish-convex-small-fillet-invalid.firmament", "diagnostic":"ProfileBoundaryFilletConvexArcSpindleUnsupported"}
    ]
  },
  "pmi":{"manual":"Datum and HoleDiameter", "projected":"Named validated Require -> From + As: HoleDiameter + DatumRefs", "supportedKinds":["Datum", "HoleDiameter"], "unsupported":["automatic Concept-to-PMI", "automatic Require export", "ontology inference", "other PMI kinds"]},
  "step":{"schema":"AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF (Aetheris canonical AP242 subset)", "emittedSurfaceFamilies":["Plane", "Cylinder", "Cone", "Sphere", "Torus", "Hyperbola where analytically applicable"], "emittedCurveFamilies":["line", "circle", "arc"], "orientation":"topological traversal is independent from analytic parameter direction; EDGE_CURVE.same_sense is preserved", "determinism":"fixed source/route emits canonical deterministic STEP and advertised routes reimport/manifold-check", "importLimits":["canonical Aetheris AP242 required for InlineStep", "no general foreign STEP family guarantee", "no mesh/NURBS production export", "no automatic decompilation"]},
  "verification":{"assertVolume":"literal-only expected value, absolute tolerance, build-time STEP-reimport measurement, JSON result, no STEP mutation", "massPropertyNotes":["curved trimmed faces can report conservative deterministic error bounds", "mixed whole-loop Fillet remains experimental until this is tightened"]},
  "invalidFixtures":[
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Hole/hole-x4-unknown.invalid.firmfixture", "diagnostic":"unknown Hole variant"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Hole/hole-x4-bad-counterbore.invalid.firmfixture", "diagnostic":"malformed Hole fields"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/PMI/pmi-projection-override-value.firmament", "diagnostic":"firmament-v2-pmi-projected-field-must-not-override-source-constraint"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/PMI/pmi-projection-failed-require.firmament", "diagnostic":"Require validation gate"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Geometry/concept-path-open-profile.firmament", "diagnostic":"open profile"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Geometry/profile-compose-l-bracket-edgefinish-unsupported.firmament", "diagnostic":"unsupported EdgeFinish route"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Geometry/profile-compose-reflex-chamfer-shaft-collision.firmament", "diagnostic":"ProfileBoundaryChamferIntersectsShaft"},
    {"fixturePath":"fixtures/Compatibility/LegacyAliases/Invalid/Geometry/profile-compose-reflex-chamfer-counterbore-collision.firmament", "diagnostic":"ProfileBoundaryChamferIntersectsCounterbore"}
  ],
  "testBaseline":{"dotnetSdk":"10.0.302", "build":{"warnings":0,"nullableWarnings":0,"analyzerWarnings":0,"errors":0}, "tests":{"Aetheris.Kernel.Core.Tests":994,"Aetheris.Kernel.Firmament.Tests":1023,"Aetheris.CLI.Tests":337,"Aetheris.Server.Tests":41,"frontend":55}, "frontend":{"buildWarnings":0,"npmAuditAdvisories":0}},
  "releaseBlockers":[
    {"id":"curved-trim-mass-verification", "ownerArea":"Kernel/verification", "affectedFeature":"fillet-mixed-whole-loop", "affectedFeatureStatus":"Experimental", "reason":"Certified volume error envelope is approximately 41k mm^3.", "requiredEvidence":"Tight deterministic reimport mass evidence.", "codeChangesAllowed":true},
    {"id":"whole-loop-fillet-promotion", "ownerArea":"Firmament/geometry", "affectedFeature":"fillet-mixed-whole-loop", "affectedFeatureStatus":"Experimental", "reason":"Do not promote executable card without release-tight verification and external-kernel smoke.", "requiredEvidence":"Blocker closure plus interoperability artifact.", "codeChangesAllowed":true},
    {"id":"release-ux-evidence", "ownerArea":"CLI/Cadmata/VS Code", "affectedFeature":"release-experience", "affectedFeatureStatus":"Unsupported", "reason":"Clean-machine install and public authoring UX evidence are outstanding.", "requiredEvidence":"Documented clean-machine and public-doc run.", "codeChangesAllowed":true}
  ],
  "changeControl":{"allowedCategories":["BUG","RELEASE-BLOCKER","DOCS","UX","PACKAGING","INTEROP","TEST","SECURITY","DEPENDENCY","PERFORMANCE-REGRESSION"], "otherwise":"defer to post-Preview-1", "geometryRule":"No new geometry unless it fixes an advertised capability or verified correctness/interoperability bug in one."}
}