feat: add candidate FreeCAD naming SDK and attachment oracles

Build and verify the candidate-only FreeCAD naming bridge and OCCT worker path, including three-stage StringHasher restoration. Add Datum, ShapeBinder, attachment-mode, and PartDesign structure oracles plus offline SDK build plans and CI boundary checks.
2026-08-13 17:16:07 -04:00
parent 58c0807219
commit f97eae4153
79 changed files with 7936 additions and 77 deletions
--- a/config/freecad-private-naming-source-readiness.json
+++ b/config/freecad-private-naming-source-readiness.json
@@ -0,0 +1,106 @@
+{
+  "schemaVersion": 1,
+  "scope": "standalone-wasm-source-prerequisite",
+  "baseline": {
+    "freecadVersion": "1.1.1",
+    "sourceCommit": "0108fd4b4850cc46e625b60e53cea7a7bbe69f8d",
+    "emscriptenVersion": "3.1.69",
+    "qtVersion": "6.8.2"
+  },
+  "linkedOriginalSources": [
+    {
+      "path": "src/App/IndexedName.cpp",
+      "sha256": "73e0e60a9d6ee06851252e2071ebdd58698f8f99733903232529b3a194164435"
+    },
+    {
+      "path": "src/App/MappedName.cpp",
+      "sha256": "90173aba5f331ac9453589833f7e5fc63c5c80a35f1600dbc71211606b1c9dbc"
+    },
+    {
+      "path": "src/App/StringHasher.cpp",
+      "sha256": "fd32f35c9c2a0c21a60fa634ec37ec594d6f331924c5bba7fdbbcb351c3b612c"
+    },
+    {
+      "path": "src/App/MappedElement.cpp",
+      "sha256": "f5448d9de693e319460d5e3ef52c63a54e0948963e4b92786aac38c77bdcd7a5"
+    },
+    {
+      "path": "src/App/ElementNamingUtils.cpp",
+      "sha256": "fc3223857ca6d2990d2b48f437f75841cdf23e1e79fa18ef18296f40acd3cdc3"
+    },
+    {
+      "path": "src/App/ElementMap.cpp",
+      "sha256": "e1ceaedb624688ddffa6a834c1b32539e8ba5bbdc0ec31401ea087e6a9c3eb52"
+    },
+    {
+      "path": "src/Base/Handle.cpp",
+      "sha256": "8f02d27a8b672e9a56764f85e394265b4fcf023aba097f040b03dcb38bc393d2"
+    }
+  ],
+  "runtimeAssertions": [
+    "IndexedName parsing",
+    "MappedName postfix tag parsing",
+    "StringHasher duplicate identity",
+    "StringHasher SHA-1 threshold",
+    "StringHasher mapped indexed-name references",
+    "ElementMap StringHasher encoding",
+    "ElementMap bidirectional lookup",
+    "ElementMap history tracing",
+    "ElementMap save and restore",
+    "MappedElement stable ordering",
+    "seven-object wasm static archive linkage"
+  ],
+  "hostAdapterScope": [
+    "Base persistence streams",
+    "Base type-system declarations",
+    "Python wrapper objects",
+    "logging",
+    "Application and Document lifecycle hooks"
+  ],
+  "isolatedSourceArchive": {
+    "path": "native/freecad-naming-probe/dist/libFreeCADPrivateNamingProbe.a",
+    "target": "wasm32-emscripten",
+    "expectedObjectMembers": 7,
+    "hostAdapterBound": true,
+    "productionEligible": false
+  },
+  "notLinkedProductionComponents": [
+    "FreeCADBase static library",
+    "FreeCADApp static library",
+    "Part static library",
+    "Python static library",
+    "real Application and Document integration",
+    "FreeCAD private naming Worker bridge"
+  ],
+  "candidateAbi": {
+    "scope": "isolated-non-production",
+    "exports": [
+      "freecadNamingCandidateAbiVersion",
+      "freecadNamingCandidateCapabilitiesJson",
+      "freecadNamingCandidateEvidenceJson"
+    ],
+    "strictWebValidator": "pass",
+    "nativeResources": [
+      "MappedNameRef",
+      "StringHasher",
+      "ElementMap2"
+    ],
+    "occtBuilderContext": false,
+    "publishToWorker": false
+  },
+  "production": {
+    "workerArtifact": "native/occt-history/dist/bitbybit-occt-history.wasm",
+    "workerLinked": false,
+    "exportedCallbacks": [],
+    "requiredCallbacks": [
+      "freecadNamingAbiVersion",
+      "freecadNamingCapabilitiesJson",
+      "freecadNamingEvidenceJson"
+    ]
+  },
+  "boundary": {
+    "freecadNamingBuildStatus": "contract-only",
+    "exTsn02": "in_progress",
+    "systemExact": false
+  }
+}