@coloopx/colocad 0.1.0-alpha.6 → 0.1.0-alpha.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +64 -0
- package/README.md +14 -3
- package/README.zh-CN.md +13 -3
- package/ROADMAP.md +125 -0
- package/ROADMAP.zh-CN.md +91 -0
- package/bin/colocad.mjs +17 -9
- package/docs/README.md +13 -2
- package/docs/README.zh-CN.md +12 -3
- package/docs/agent-modeling-handbook.md +12 -4
- package/docs/agent-modeling-handbook.zh-CN.md +21 -4
- package/docs/api.md +9 -6
- package/docs/best-practices.md +80 -3
- package/docs/best-practices.zh-CN.md +63 -0
- package/docs/cadquery-comparison.md +105 -0
- package/docs/cadquery-comparison.zh-CN.md +53 -0
- package/docs/cadquery-coverage.json +762 -0
- package/docs/engineering-queries.md +124 -0
- package/docs/engineering-queries.zh-CN.md +76 -0
- package/docs/getting-started.md +1 -1
- package/docs/integrations/claude-code.md +1 -1
- package/docs/integrations/codex.md +1 -1
- package/docs/integrations/overview.md +3 -1
- package/docs/integrations/pi.md +17 -4
- package/docs/integrations/verification.md +7 -1
- package/docs/troubleshooting.md +13 -1
- package/examples/integrations/README.md +11 -2
- package/examples/integrations/compact-tools.mjs +1 -1
- package/kernel/dist/client.d.ts +5 -2
- package/kernel/dist/client.js +35 -7
- package/kernel/dist/generated.d.ts +297 -4
- package/kernel/dist/process.d.ts +1 -1
- package/kernel/dist/process.js +3 -3
- package/kernel/dist/query-generated.d.ts +181 -0
- package/kernel/dist/query-generated.js +1 -0
- package/kernel/dist/tools.d.ts +35 -0
- package/kernel/dist/tools.js +11 -2
- package/kernel/dist/types.d.ts +9 -0
- package/kernel/native/darwin-arm64/agent-cad +2 -2
- package/kernel/native/darwin-arm64/manifest.json +2 -2
- package/kernel/native/linux-arm64/agent-cad +2 -2
- package/kernel/native/linux-arm64/manifest.json +2 -2
- package/kernel/native/linux-x64/agent-cad +2 -2
- package/kernel/native/linux-x64/manifest.json +2 -2
- package/kernel/release.json +4 -4
- package/kernel/schemas/model.schema.json +1752 -135
- package/kernel/schemas/query.schema.json +1150 -0
- package/package.json +8 -2
- package/skills/colocad/SKILL.md +1 -0
- package/skills/colocad/references/modeling-loop.md +15 -1
- package/skills/colocad/references/prompt-patterns.md +27 -1
- package/skills/colocad/references/quick-build.md +2 -0
- package/skills/colocad/references/tool-contracts.md +14 -2
- package/skills/colocad/references/tuning.md +5 -1
- package/src/build.mjs +3 -2
- package/src/index.d.mts +2 -1
- package/src/session.d.mts +5 -3
- package/src/session.mjs +26 -10
- package/viewer/dist/index.js +179 -179
- package/viewer/dist/standalone.js +179 -179
- package/viewer/index.d.ts +2 -1
|
@@ -0,0 +1,762 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "colocad.cadquery-coverage/1",
|
|
3
|
+
"date": "2026-11-10",
|
|
4
|
+
"colocad_version": "0.1.0-alpha.8",
|
|
5
|
+
"upstream": {
|
|
6
|
+
"repository": "https://github.com/CadQuery/cadquery",
|
|
7
|
+
"commit": "b3f9afd4f39cbd856d0c46aa30aa37b714b8f6cb",
|
|
8
|
+
"path": "doc/apireference.rst",
|
|
9
|
+
"sha256": "b49b4c21dc36f38405db557b87c4aaa2d43774dd98bcb9d86c7a96dd1925742e",
|
|
10
|
+
"official_api_url": "https://cadquery.readthedocs.io/en/latest/apireference.html",
|
|
11
|
+
"retrieved_date": "2026-11-10"
|
|
12
|
+
},
|
|
13
|
+
"scope": "All 150 unique entries in the cited API index, plus narrative review of lower-level APIs. This is a source/contract mapping, not a 150-case differential test or full CadQuery coverage percentage. Latest docs are mutable and may differ from the pinned source.",
|
|
14
|
+
"python_api_compatible": false,
|
|
15
|
+
"statuses": {
|
|
16
|
+
"supported_domain": "Native analogous operation exists within its stated contract; not identical signature or complete behavioral equivalence.",
|
|
17
|
+
"partial": "Relevant native capability exists, with material semantic/domain gaps.",
|
|
18
|
+
"recipe": "Caller may compose existing primitives; a dedicated equivalent is absent and not generally verified.",
|
|
19
|
+
"unsupported": "No corresponding public contract currently offered.",
|
|
20
|
+
"different_abstraction": "A deliberate graph/session/typed-JSON alternative; no API substitution."
|
|
21
|
+
},
|
|
22
|
+
"api_count": 150,
|
|
23
|
+
"counts_by_status": {
|
|
24
|
+
"different_abstraction": 26,
|
|
25
|
+
"unsupported": 29,
|
|
26
|
+
"supported_domain": 36,
|
|
27
|
+
"recipe": 29,
|
|
28
|
+
"partial": 30
|
|
29
|
+
},
|
|
30
|
+
"groups": [
|
|
31
|
+
{
|
|
32
|
+
"id": "sketch-context",
|
|
33
|
+
"status": "different_abstraction",
|
|
34
|
+
"apis": [
|
|
35
|
+
"Sketch",
|
|
36
|
+
"Workplane.sketch",
|
|
37
|
+
"Sketch.finalize",
|
|
38
|
+
"Sketch.copy",
|
|
39
|
+
"Sketch.located",
|
|
40
|
+
"Sketch.moved",
|
|
41
|
+
"Workplane",
|
|
42
|
+
"Workplane.center",
|
|
43
|
+
"Workplane.moveTo",
|
|
44
|
+
"Workplane.move",
|
|
45
|
+
"Workplane.placeSketch"
|
|
46
|
+
],
|
|
47
|
+
"colocad": "Explicit Profile/Sketch values and orthogonal Frame; caller owns source copies and frames.",
|
|
48
|
+
"boundary": "No mutable Workplane/Sketch chain or stack context compatibility.",
|
|
49
|
+
"implementation": [
|
|
50
|
+
"crates/agent-cad/src/operations.rs",
|
|
51
|
+
"crates/agent-cad/src/sketch.rs"
|
|
52
|
+
],
|
|
53
|
+
"evidence": [
|
|
54
|
+
"crates/agent-cad/tests/parity.rs",
|
|
55
|
+
"crates/agent-cad/tests/sketch.rs"
|
|
56
|
+
],
|
|
57
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"id": "sketch-state",
|
|
61
|
+
"status": "different_abstraction",
|
|
62
|
+
"apis": [
|
|
63
|
+
"Sketch.tag",
|
|
64
|
+
"Sketch.select",
|
|
65
|
+
"Sketch.reset",
|
|
66
|
+
"Sketch.delete",
|
|
67
|
+
"Sketch.push"
|
|
68
|
+
],
|
|
69
|
+
"colocad": "Named sketch points/circles/constraints and explicit source edits.",
|
|
70
|
+
"boundary": "Not tag-based selection of arbitrary sketch faces or mutable selection state.",
|
|
71
|
+
"implementation": [
|
|
72
|
+
"crates/agent-cad/src/sketch.rs"
|
|
73
|
+
],
|
|
74
|
+
"evidence": [],
|
|
75
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"id": "sketch-topology",
|
|
79
|
+
"status": "unsupported",
|
|
80
|
+
"apis": [
|
|
81
|
+
"Sketch.faces",
|
|
82
|
+
"Sketch.edges",
|
|
83
|
+
"Sketch.vertices",
|
|
84
|
+
"Sketch.face",
|
|
85
|
+
"Sketch.edge",
|
|
86
|
+
"Sketch.assemble"
|
|
87
|
+
],
|
|
88
|
+
"colocad": "No general sketch topology editing API.",
|
|
89
|
+
"boundary": "Solid snapshot queries do not supply an equivalent 2D face/edge editor.",
|
|
90
|
+
"implementation": [
|
|
91
|
+
"crates/agent-cad/src/sketch.rs",
|
|
92
|
+
"crates/agent-cad/src/operations.rs"
|
|
93
|
+
],
|
|
94
|
+
"evidence": [],
|
|
95
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"id": "basic-profiles",
|
|
99
|
+
"status": "supported_domain",
|
|
100
|
+
"apis": [
|
|
101
|
+
"Sketch.rect",
|
|
102
|
+
"Sketch.circle",
|
|
103
|
+
"Sketch.ellipse",
|
|
104
|
+
"Sketch.polygon",
|
|
105
|
+
"Workplane.rect",
|
|
106
|
+
"Workplane.circle",
|
|
107
|
+
"Workplane.ellipse",
|
|
108
|
+
"Workplane.polyline"
|
|
109
|
+
],
|
|
110
|
+
"colocad": "rectangle/circle/ellipse/polygon profiles.",
|
|
111
|
+
"boundary": "Closed profile construction; not every CadQuery mode, construction geometry or stack overload.",
|
|
112
|
+
"implementation": [
|
|
113
|
+
"crates/agent-cad/src/operations.rs"
|
|
114
|
+
],
|
|
115
|
+
"evidence": [
|
|
116
|
+
"crates/agent-cad/tests/parity.rs"
|
|
117
|
+
],
|
|
118
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"id": "profile-recipes",
|
|
122
|
+
"status": "recipe",
|
|
123
|
+
"apis": [
|
|
124
|
+
"Sketch.trapezoid",
|
|
125
|
+
"Sketch.slot",
|
|
126
|
+
"Sketch.regularPolygon",
|
|
127
|
+
"Workplane.slot2D"
|
|
128
|
+
],
|
|
129
|
+
"colocad": "Generate polygon or line/arc outline coordinates.",
|
|
130
|
+
"boundary": "Caller must compute the profile; no dedicated constructors or equality claim for every corner case.",
|
|
131
|
+
"implementation": [
|
|
132
|
+
"crates/agent-cad/src/operations.rs"
|
|
133
|
+
],
|
|
134
|
+
"evidence": [],
|
|
135
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"id": "lines-arcs",
|
|
139
|
+
"status": "supported_domain",
|
|
140
|
+
"apis": [
|
|
141
|
+
"Sketch.segment",
|
|
142
|
+
"Sketch.arc",
|
|
143
|
+
"Sketch.close",
|
|
144
|
+
"Workplane.lineTo",
|
|
145
|
+
"Workplane.threePointArc",
|
|
146
|
+
"Workplane.close"
|
|
147
|
+
],
|
|
148
|
+
"colocad": "Outline line/three-point arc segments, or constrained sketch boundaries.",
|
|
149
|
+
"boundary": "Explicit end/via points and closed profiles; no fluent pending-edge behavior.",
|
|
150
|
+
"implementation": [
|
|
151
|
+
"crates/agent-cad/src/operations.rs",
|
|
152
|
+
"crates/agent-cad/src/sketch.rs"
|
|
153
|
+
],
|
|
154
|
+
"evidence": [
|
|
155
|
+
"crates/agent-cad/tests/parity.rs",
|
|
156
|
+
"crates/agent-cad/tests/sketch.rs"
|
|
157
|
+
],
|
|
158
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
"id": "relative-lines",
|
|
162
|
+
"status": "recipe",
|
|
163
|
+
"apis": [
|
|
164
|
+
"Workplane.line",
|
|
165
|
+
"Workplane.vLine",
|
|
166
|
+
"Workplane.vLineTo",
|
|
167
|
+
"Workplane.hLine",
|
|
168
|
+
"Workplane.hLineTo",
|
|
169
|
+
"Workplane.polarLine",
|
|
170
|
+
"Workplane.polarLineTo",
|
|
171
|
+
"Workplane.sagittaArc",
|
|
172
|
+
"Workplane.radiusArc",
|
|
173
|
+
"Workplane.tangentArcPoint"
|
|
174
|
+
],
|
|
175
|
+
"colocad": "Compute endpoints/via points in the SDK caller and emit outline segments.",
|
|
176
|
+
"boundary": "Geometric branch and tangency decisions are caller responsibilities.",
|
|
177
|
+
"implementation": [
|
|
178
|
+
"crates/agent-cad/src/operations.rs"
|
|
179
|
+
],
|
|
180
|
+
"evidence": [],
|
|
181
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"id": "profile-arrays",
|
|
185
|
+
"status": "recipe",
|
|
186
|
+
"apis": [
|
|
187
|
+
"Sketch.rarray",
|
|
188
|
+
"Sketch.parray",
|
|
189
|
+
"Sketch.each",
|
|
190
|
+
"Sketch.distribute",
|
|
191
|
+
"Workplane.rarray",
|
|
192
|
+
"Workplane.polarArray",
|
|
193
|
+
"Workplane.each",
|
|
194
|
+
"Workplane.eachpoint"
|
|
195
|
+
],
|
|
196
|
+
"colocad": "Caller generates locations/source features; native pattern and shared occurrences cover repeated solids.",
|
|
197
|
+
"boundary": "No callback execution or edge-distribution/stack placement API in the native protocol.",
|
|
198
|
+
"implementation": [
|
|
199
|
+
"crates/agent-cad/src/model.rs",
|
|
200
|
+
"crates/agent-cad/src/placement.rs"
|
|
201
|
+
],
|
|
202
|
+
"evidence": [],
|
|
203
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
204
|
+
},
|
|
205
|
+
{
|
|
206
|
+
"id": "sketch-advanced-edit",
|
|
207
|
+
"status": "unsupported",
|
|
208
|
+
"apis": [
|
|
209
|
+
"Sketch.hull",
|
|
210
|
+
"Sketch.offset",
|
|
211
|
+
"Sketch.fillet",
|
|
212
|
+
"Sketch.chamfer",
|
|
213
|
+
"Sketch.clean",
|
|
214
|
+
"Workplane.offset2D"
|
|
215
|
+
],
|
|
216
|
+
"colocad": "No public general 2D wire/face offset, hull, cleanup or selection-based corner editor.",
|
|
217
|
+
"boundary": "Internal profile offsets used by selected solid operations are not a general sketch API.",
|
|
218
|
+
"implementation": [
|
|
219
|
+
"crates/agent-cad/src/operations.rs"
|
|
220
|
+
],
|
|
221
|
+
"evidence": [],
|
|
222
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"id": "general-splines",
|
|
226
|
+
"status": "unsupported",
|
|
227
|
+
"apis": [
|
|
228
|
+
"Sketch.spline",
|
|
229
|
+
"Workplane.spline",
|
|
230
|
+
"Workplane.parametricCurve",
|
|
231
|
+
"Workplane.parametricSurface",
|
|
232
|
+
"Workplane.ellipseArc",
|
|
233
|
+
"Workplane.twistExtrude",
|
|
234
|
+
"Workplane.text"
|
|
235
|
+
],
|
|
236
|
+
"colocad": "No equivalent arbitrary interpolating spline, function-sampling curve/surface, elliptical arc, twist-extrusion or text API.",
|
|
237
|
+
"boundary": "Bezier path/control surfaces are different bounded capabilities.",
|
|
238
|
+
"implementation": [
|
|
239
|
+
"crates/agent-cad/src/model.rs",
|
|
240
|
+
"crates/agent-cad/src/operations.rs"
|
|
241
|
+
],
|
|
242
|
+
"evidence": [],
|
|
243
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
244
|
+
},
|
|
245
|
+
{
|
|
246
|
+
"id": "sketch-constraints",
|
|
247
|
+
"status": "partial",
|
|
248
|
+
"apis": [
|
|
249
|
+
"Sketch.constrain",
|
|
250
|
+
"Sketch.solve"
|
|
251
|
+
],
|
|
252
|
+
"colocad": "Named geometric constraints, local numerical solver, residual and DOF diagnostics.",
|
|
253
|
+
"boundary": "Finite variable/equation budgets and selected point/line/circle constraints; no blanket nonlinear solver equivalence.",
|
|
254
|
+
"implementation": [
|
|
255
|
+
"crates/agent-cad/src/sketch.rs",
|
|
256
|
+
"crates/agent-cad/src/solve.rs"
|
|
257
|
+
],
|
|
258
|
+
"evidence": [
|
|
259
|
+
"crates/agent-cad/tests/sketch.rs"
|
|
260
|
+
],
|
|
261
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
262
|
+
},
|
|
263
|
+
{
|
|
264
|
+
"id": "sketch-mirror-wire",
|
|
265
|
+
"status": "recipe",
|
|
266
|
+
"apis": [
|
|
267
|
+
"Workplane.mirrorX",
|
|
268
|
+
"Workplane.mirrorY",
|
|
269
|
+
"Workplane.wire"
|
|
270
|
+
],
|
|
271
|
+
"colocad": "Reflect profile coordinates and emit a closed outline/polygon.",
|
|
272
|
+
"boundary": "No pending-wire graph or automatic multi-wire assembly semantics.",
|
|
273
|
+
"implementation": [
|
|
274
|
+
"crates/agent-cad/src/operations.rs"
|
|
275
|
+
],
|
|
276
|
+
"evidence": [],
|
|
277
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
278
|
+
},
|
|
279
|
+
{
|
|
280
|
+
"id": "basic-solids",
|
|
281
|
+
"status": "supported_domain",
|
|
282
|
+
"apis": [
|
|
283
|
+
"Workplane.box",
|
|
284
|
+
"Workplane.sphere",
|
|
285
|
+
"Workplane.cylinder"
|
|
286
|
+
],
|
|
287
|
+
"colocad": "Native box/sphere/cylinder.",
|
|
288
|
+
"boundary": "Explicit placement and mm units; sphere angular truncation/stack overloads are not claimed.",
|
|
289
|
+
"implementation": [
|
|
290
|
+
"crates/agent-cad/src/model.rs"
|
|
291
|
+
],
|
|
292
|
+
"evidence": [
|
|
293
|
+
"crates/agent-cad/tests/geometry.rs",
|
|
294
|
+
"crates/agent-cad/tests/parity.rs"
|
|
295
|
+
],
|
|
296
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
297
|
+
},
|
|
298
|
+
{
|
|
299
|
+
"id": "wedge",
|
|
300
|
+
"status": "recipe",
|
|
301
|
+
"apis": [
|
|
302
|
+
"Workplane.wedge"
|
|
303
|
+
],
|
|
304
|
+
"colocad": "Extrude an explicit polygon or use a specified loft.",
|
|
305
|
+
"boundary": "No direct wedge signature.",
|
|
306
|
+
"implementation": [
|
|
307
|
+
"crates/agent-cad/src/model.rs"
|
|
308
|
+
],
|
|
309
|
+
"evidence": [],
|
|
310
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
311
|
+
},
|
|
312
|
+
{
|
|
313
|
+
"id": "booleans",
|
|
314
|
+
"status": "supported_domain",
|
|
315
|
+
"apis": [
|
|
316
|
+
"Workplane.cut",
|
|
317
|
+
"Workplane.union",
|
|
318
|
+
"Workplane.intersect"
|
|
319
|
+
],
|
|
320
|
+
"colocad": "Native exact cut/union/intersect on feature IDs.",
|
|
321
|
+
"boundary": "Different kernel; no OCCT glue/tolerance compatibility or universal success-rate guarantee.",
|
|
322
|
+
"implementation": [
|
|
323
|
+
"crates/agent-cad/src/executor.rs"
|
|
324
|
+
],
|
|
325
|
+
"evidence": [
|
|
326
|
+
"crates/agent-cad/tests/geometry.rs",
|
|
327
|
+
"specs/experiments/0005/README.md"
|
|
328
|
+
],
|
|
329
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
330
|
+
},
|
|
331
|
+
{
|
|
332
|
+
"id": "stack-combine",
|
|
333
|
+
"status": "recipe",
|
|
334
|
+
"apis": [
|
|
335
|
+
"Workplane.combine"
|
|
336
|
+
],
|
|
337
|
+
"colocad": "Explicit union graph, or separate named assembly instances.",
|
|
338
|
+
"boundary": "Fusion and assembly are distinct operations; no implicit stack combination.",
|
|
339
|
+
"implementation": [
|
|
340
|
+
"crates/agent-cad/src/model.rs",
|
|
341
|
+
"crates/agent-cad/src/assembly.rs"
|
|
342
|
+
],
|
|
343
|
+
"evidence": [],
|
|
344
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
345
|
+
},
|
|
346
|
+
{
|
|
347
|
+
"id": "extrusions",
|
|
348
|
+
"status": "partial",
|
|
349
|
+
"apis": [
|
|
350
|
+
"Workplane.extrude",
|
|
351
|
+
"Workplane.cutBlind",
|
|
352
|
+
"Workplane.cutThruAll"
|
|
353
|
+
],
|
|
354
|
+
"colocad": "extrude/draft_extrude/cutout with explicit frame and extent.",
|
|
355
|
+
"boundary": "Up-to-selected-face and automatic through-all semantics require explicit extent derivation; taper/offset restrictions differ.",
|
|
356
|
+
"implementation": [
|
|
357
|
+
"crates/agent-cad/src/model.rs",
|
|
358
|
+
"crates/agent-cad/src/operations.rs"
|
|
359
|
+
],
|
|
360
|
+
"evidence": [
|
|
361
|
+
"crates/agent-cad/tests/parity.rs"
|
|
362
|
+
],
|
|
363
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
364
|
+
},
|
|
365
|
+
{
|
|
366
|
+
"id": "holes",
|
|
367
|
+
"status": "partial",
|
|
368
|
+
"apis": [
|
|
369
|
+
"Workplane.hole",
|
|
370
|
+
"Workplane.cboreHole"
|
|
371
|
+
],
|
|
372
|
+
"colocad": "holes/face_holes/hole_grid/face_hole_grid and counterbore options.",
|
|
373
|
+
"boundary": "Explicit radius, depth and frame; not every Workplane context/automatic depth overload.",
|
|
374
|
+
"implementation": [
|
|
375
|
+
"crates/agent-cad/src/engineering.rs",
|
|
376
|
+
"crates/agent-cad/src/grid.rs"
|
|
377
|
+
],
|
|
378
|
+
"evidence": [
|
|
379
|
+
"crates/agent-cad/tests/query_artifacts.rs",
|
|
380
|
+
"crates/agent-cad/tests/parity.rs"
|
|
381
|
+
],
|
|
382
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
383
|
+
},
|
|
384
|
+
{
|
|
385
|
+
"id": "countersink",
|
|
386
|
+
"status": "recipe",
|
|
387
|
+
"apis": [
|
|
388
|
+
"Workplane.cskHole"
|
|
389
|
+
],
|
|
390
|
+
"colocad": "Subtract explicit cone/cylinder cutters.",
|
|
391
|
+
"boundary": "No dedicated countersink operation or complete countersink recognition contract.",
|
|
392
|
+
"implementation": [
|
|
393
|
+
"crates/agent-cad/src/model.rs"
|
|
394
|
+
],
|
|
395
|
+
"evidence": [],
|
|
396
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
397
|
+
},
|
|
398
|
+
{
|
|
399
|
+
"id": "loft-sweep",
|
|
400
|
+
"status": "partial",
|
|
401
|
+
"apis": [
|
|
402
|
+
"Workplane.loft",
|
|
403
|
+
"Workplane.sweep",
|
|
404
|
+
"Workplane.revolve"
|
|
405
|
+
],
|
|
406
|
+
"colocad": "profile_loft/loft/sweep/curve_sweep/pipe/revolve.",
|
|
407
|
+
"boundary": "Bounded corresponding sections; planar sweep or one line/arc/Bezier path; no general multi-rail/Frenet/twisted sweep parity.",
|
|
408
|
+
"implementation": [
|
|
409
|
+
"crates/agent-cad/src/model.rs",
|
|
410
|
+
"crates/agent-cad/src/capabilities.rs"
|
|
411
|
+
],
|
|
412
|
+
"evidence": [
|
|
413
|
+
"crates/agent-cad/tests/parity.rs"
|
|
414
|
+
],
|
|
415
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
416
|
+
},
|
|
417
|
+
{
|
|
418
|
+
"id": "finish-features",
|
|
419
|
+
"status": "partial",
|
|
420
|
+
"apis": [
|
|
421
|
+
"Workplane.shell",
|
|
422
|
+
"Workplane.fillet",
|
|
423
|
+
"Workplane.chamfer",
|
|
424
|
+
"Workplane.split"
|
|
425
|
+
],
|
|
426
|
+
"colocad": "Semantic edge selectors, native blends/shells and explicit split tools.",
|
|
427
|
+
"boundary": "Selector families and algorithm success domains differ; unequal-length chamfer and all CadQuery overloads are not established.",
|
|
428
|
+
"implementation": [
|
|
429
|
+
"crates/agent-cad/src/operations.rs",
|
|
430
|
+
"crates/agent-cad/src/model.rs"
|
|
431
|
+
],
|
|
432
|
+
"evidence": [
|
|
433
|
+
"crates/agent-cad/tests/parity.rs",
|
|
434
|
+
"specs/experiments/0005/README.md"
|
|
435
|
+
],
|
|
436
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
437
|
+
},
|
|
438
|
+
{
|
|
439
|
+
"id": "transforms",
|
|
440
|
+
"status": "supported_domain",
|
|
441
|
+
"apis": [
|
|
442
|
+
"Workplane.rotate",
|
|
443
|
+
"Workplane.translate",
|
|
444
|
+
"Workplane.mirror"
|
|
445
|
+
],
|
|
446
|
+
"colocad": "Explicit rigid placement/rotation/translation/mirror.",
|
|
447
|
+
"boundary": "No stack semantics; mirror may produce a new feature or occurrence as specified.",
|
|
448
|
+
"implementation": [
|
|
449
|
+
"crates/agent-cad/src/placement.rs"
|
|
450
|
+
],
|
|
451
|
+
"evidence": [
|
|
452
|
+
"crates/agent-cad/tests/parity.rs"
|
|
453
|
+
],
|
|
454
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
455
|
+
},
|
|
456
|
+
{
|
|
457
|
+
"id": "center-rotation",
|
|
458
|
+
"status": "recipe",
|
|
459
|
+
"apis": [
|
|
460
|
+
"Workplane.rotateAboutCenter"
|
|
461
|
+
],
|
|
462
|
+
"colocad": "Compute/select the intended center and pass an explicit rotation origin.",
|
|
463
|
+
"boundary": "Bounding-box center and mass center must not be conflated.",
|
|
464
|
+
"implementation": [
|
|
465
|
+
"crates/agent-cad/src/placement.rs"
|
|
466
|
+
],
|
|
467
|
+
"evidence": [],
|
|
468
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
469
|
+
},
|
|
470
|
+
{
|
|
471
|
+
"id": "dxf-svg",
|
|
472
|
+
"status": "unsupported",
|
|
473
|
+
"apis": [
|
|
474
|
+
"Sketch.importDXF",
|
|
475
|
+
"Workplane.toSvg",
|
|
476
|
+
"Workplane.exportSvg",
|
|
477
|
+
"importers.importDXF",
|
|
478
|
+
"occ_impl.exporters.dxf.DxfDocument"
|
|
479
|
+
],
|
|
480
|
+
"colocad": "No public DXF import/export or SVG projection API.",
|
|
481
|
+
"boundary": "PNG/HTML review is not vector drawing interchange.",
|
|
482
|
+
"implementation": [
|
|
483
|
+
"crates/agent-cad/src/capabilities.rs"
|
|
484
|
+
],
|
|
485
|
+
"evidence": [],
|
|
486
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
487
|
+
},
|
|
488
|
+
{
|
|
489
|
+
"id": "step-import",
|
|
490
|
+
"status": "partial",
|
|
491
|
+
"apis": [
|
|
492
|
+
"importers.importStep"
|
|
493
|
+
],
|
|
494
|
+
"colocad": "Registered STEP assets, inspectStep/attachStep/import_step and native product hierarchy.",
|
|
495
|
+
"boundary": "Rigid placements and supported representations only; mixed units/nonrigid mappings and unsupported entities can be rejected.",
|
|
496
|
+
"implementation": [
|
|
497
|
+
"crates/agent-cad/src/step_assembly.rs",
|
|
498
|
+
"crates/agent-cad/src/capabilities.rs"
|
|
499
|
+
],
|
|
500
|
+
"evidence": [
|
|
501
|
+
"crates/agent-cad/tests/assembly_tree.rs",
|
|
502
|
+
"crates/agent-cad/tests/foreign_queries.rs"
|
|
503
|
+
],
|
|
504
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
505
|
+
},
|
|
506
|
+
{
|
|
507
|
+
"id": "export",
|
|
508
|
+
"status": "partial",
|
|
509
|
+
"apis": [
|
|
510
|
+
"exporters.export",
|
|
511
|
+
"Assembly.save"
|
|
512
|
+
],
|
|
513
|
+
"colocad": "Exact STEP solids/surfaces and assembly trees; STL/GLB/PNG plus feature source/session HTML.",
|
|
514
|
+
"boundary": "No equivalent full CadQuery exporter format matrix; STEP does not export editable native feature history.",
|
|
515
|
+
"implementation": [
|
|
516
|
+
"crates/agent-cad/src/exchange.rs",
|
|
517
|
+
"crates/agent-cad/src/step_assembly.rs",
|
|
518
|
+
"src/session.mjs"
|
|
519
|
+
],
|
|
520
|
+
"evidence": [
|
|
521
|
+
"test/validation/packed.mjs"
|
|
522
|
+
],
|
|
523
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
524
|
+
},
|
|
525
|
+
{
|
|
526
|
+
"id": "stack",
|
|
527
|
+
"status": "different_abstraction",
|
|
528
|
+
"apis": [
|
|
529
|
+
"Workplane.all",
|
|
530
|
+
"Workplane.size",
|
|
531
|
+
"Workplane.vals",
|
|
532
|
+
"Workplane.add",
|
|
533
|
+
"Workplane.val",
|
|
534
|
+
"Workplane.first",
|
|
535
|
+
"Workplane.item",
|
|
536
|
+
"Workplane.last",
|
|
537
|
+
"Workplane.end"
|
|
538
|
+
],
|
|
539
|
+
"colocad": "Explicit feature graph, IDs, session accepted source and query result arrays.",
|
|
540
|
+
"boundary": "No Workplane object stack/parent chain compatibility; host array access is not a modeling feature.",
|
|
541
|
+
"implementation": [
|
|
542
|
+
"crates/agent-cad/src/model.rs",
|
|
543
|
+
"src/session.mjs"
|
|
544
|
+
],
|
|
545
|
+
"evidence": [],
|
|
546
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
547
|
+
},
|
|
548
|
+
{
|
|
549
|
+
"id": "solid-topology",
|
|
550
|
+
"status": "supported_domain",
|
|
551
|
+
"apis": [
|
|
552
|
+
"Workplane.vertices",
|
|
553
|
+
"Workplane.faces",
|
|
554
|
+
"Workplane.edges"
|
|
555
|
+
],
|
|
556
|
+
"colocad": "Revision-bound typed entities and composable query selections.",
|
|
557
|
+
"boundary": "Observed refs are invalidated by edits; query selectors are not automatically accepted by every modeling operation.",
|
|
558
|
+
"implementation": [
|
|
559
|
+
"crates/agent-cad/src/query/selection.rs",
|
|
560
|
+
"crates/agent-cad/src/query/engine.rs"
|
|
561
|
+
],
|
|
562
|
+
"evidence": [
|
|
563
|
+
"crates/agent-cad/tests/query_artifacts.rs"
|
|
564
|
+
],
|
|
565
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
566
|
+
},
|
|
567
|
+
{
|
|
568
|
+
"id": "wire-topology",
|
|
569
|
+
"status": "partial",
|
|
570
|
+
"apis": [
|
|
571
|
+
"Workplane.wires"
|
|
572
|
+
],
|
|
573
|
+
"colocad": "Ordered face loops and edge uses.",
|
|
574
|
+
"boundary": "Loops on a solid are not standalone arbitrary wires.",
|
|
575
|
+
"implementation": [
|
|
576
|
+
"crates/agent-cad/src/query/descriptors.rs"
|
|
577
|
+
],
|
|
578
|
+
"evidence": [
|
|
579
|
+
"crates/agent-cad/tests/query_artifacts.rs"
|
|
580
|
+
],
|
|
581
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
582
|
+
},
|
|
583
|
+
{
|
|
584
|
+
"id": "body-topology",
|
|
585
|
+
"status": "unsupported",
|
|
586
|
+
"apis": [
|
|
587
|
+
"Workplane.solids",
|
|
588
|
+
"Workplane.shells",
|
|
589
|
+
"Workplane.compounds"
|
|
590
|
+
],
|
|
591
|
+
"colocad": "Definitions/instances expose part results, not these generic topology selections.",
|
|
592
|
+
"boundary": "No public solid/shell/compound entity selector.",
|
|
593
|
+
"implementation": [
|
|
594
|
+
"crates/agent-cad/src/query/contract.rs"
|
|
595
|
+
],
|
|
596
|
+
"evidence": [],
|
|
597
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
598
|
+
},
|
|
599
|
+
{
|
|
600
|
+
"id": "spatial-selector",
|
|
601
|
+
"status": "unsupported",
|
|
602
|
+
"apis": [
|
|
603
|
+
"NearestToPointSelector",
|
|
604
|
+
"BoxSelector"
|
|
605
|
+
],
|
|
606
|
+
"colocad": "No direct general nearest-object or bounding-box selector in query expressions.",
|
|
607
|
+
"boundary": "A modeling Near selector and exported AABBs are not equivalent to these selectors.",
|
|
608
|
+
"implementation": [
|
|
609
|
+
"crates/agent-cad/src/query/contract.rs",
|
|
610
|
+
"crates/agent-cad/src/operations.rs"
|
|
611
|
+
],
|
|
612
|
+
"evidence": [],
|
|
613
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
614
|
+
},
|
|
615
|
+
{
|
|
616
|
+
"id": "direction-selectors",
|
|
617
|
+
"status": "partial",
|
|
618
|
+
"apis": [
|
|
619
|
+
"BaseDirSelector",
|
|
620
|
+
"ParallelDirSelector",
|
|
621
|
+
"DirectionSelector",
|
|
622
|
+
"DirectionNthSelector",
|
|
623
|
+
"PerpendicularDirSelector",
|
|
624
|
+
"DirectionMinMaxSelector",
|
|
625
|
+
"CenterNthSelector"
|
|
626
|
+
],
|
|
627
|
+
"colocad": "Planar-normal predicates, typed rank with projection/datum direction and explicit cardinality.",
|
|
628
|
+
"boundary": "Planar normal support does not cover arbitrary curve tangents; ties retained; semantics differ from CadQuery selectors.",
|
|
629
|
+
"implementation": [
|
|
630
|
+
"crates/agent-cad/src/query/contract.rs",
|
|
631
|
+
"crates/agent-cad/src/query/selection.rs"
|
|
632
|
+
],
|
|
633
|
+
"evidence": [
|
|
634
|
+
"crates/agent-cad/tests/query_artifacts.rs"
|
|
635
|
+
],
|
|
636
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
637
|
+
},
|
|
638
|
+
{
|
|
639
|
+
"id": "metric-selectors",
|
|
640
|
+
"status": "supported_domain",
|
|
641
|
+
"apis": [
|
|
642
|
+
"LengthNthSelector",
|
|
643
|
+
"AreaNthSelector",
|
|
644
|
+
"TypeSelector"
|
|
645
|
+
],
|
|
646
|
+
"colocad": "Typed class/range filters and rank by metric.",
|
|
647
|
+
"boundary": "Finite result budgets; tied rank is not silently reduced to one entity.",
|
|
648
|
+
"implementation": [
|
|
649
|
+
"crates/agent-cad/src/query/contract.rs",
|
|
650
|
+
"crates/agent-cad/src/query/selection.rs"
|
|
651
|
+
],
|
|
652
|
+
"evidence": [
|
|
653
|
+
"crates/agent-cad/tests/query_artifacts.rs"
|
|
654
|
+
],
|
|
655
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
656
|
+
},
|
|
657
|
+
{
|
|
658
|
+
"id": "radius-rank",
|
|
659
|
+
"status": "partial",
|
|
660
|
+
"apis": [
|
|
661
|
+
"RadiusNthSelector"
|
|
662
|
+
],
|
|
663
|
+
"colocad": "Radius filters/descriptors are available; nth-radius ordering must be implemented by the caller.",
|
|
664
|
+
"boundary": "No native radius rank property.",
|
|
665
|
+
"implementation": [
|
|
666
|
+
"crates/agent-cad/src/query/contract.rs"
|
|
667
|
+
],
|
|
668
|
+
"evidence": [],
|
|
669
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
670
|
+
},
|
|
671
|
+
{
|
|
672
|
+
"id": "logical-selectors",
|
|
673
|
+
"status": "supported_domain",
|
|
674
|
+
"apis": [
|
|
675
|
+
"BinarySelector",
|
|
676
|
+
"AndSelector",
|
|
677
|
+
"SumSelector",
|
|
678
|
+
"SubtractSelector",
|
|
679
|
+
"InverseSelector"
|
|
680
|
+
],
|
|
681
|
+
"colocad": "Typed union/intersection/difference and bounded all/any/not predicates.",
|
|
682
|
+
"boundary": "Set/target scope is explicit; no Python selector object compatibility.",
|
|
683
|
+
"implementation": [
|
|
684
|
+
"crates/agent-cad/src/query/contract.rs",
|
|
685
|
+
"crates/agent-cad/src/query/selection.rs"
|
|
686
|
+
],
|
|
687
|
+
"evidence": [
|
|
688
|
+
"crates/agent-cad/tests/query_artifacts.rs"
|
|
689
|
+
],
|
|
690
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
691
|
+
},
|
|
692
|
+
{
|
|
693
|
+
"id": "selector-dsl",
|
|
694
|
+
"status": "different_abstraction",
|
|
695
|
+
"apis": [
|
|
696
|
+
"StringSyntaxSelector"
|
|
697
|
+
],
|
|
698
|
+
"colocad": "JSON selection algebra.",
|
|
699
|
+
"boundary": "CadQuery selector strings are not parsed or accepted.",
|
|
700
|
+
"implementation": [
|
|
701
|
+
"crates/agent-cad/src/query/contract.rs"
|
|
702
|
+
],
|
|
703
|
+
"evidence": [],
|
|
704
|
+
"verification": "Schema/source audit; no dedicated equivalence test claimed"
|
|
705
|
+
},
|
|
706
|
+
{
|
|
707
|
+
"id": "assembly-tree",
|
|
708
|
+
"status": "supported_domain",
|
|
709
|
+
"apis": [
|
|
710
|
+
"Assembly",
|
|
711
|
+
"Assembly.add"
|
|
712
|
+
],
|
|
713
|
+
"colocad": "Named hierarchical instances, shared definitions, rigid placements and STEP product tree.",
|
|
714
|
+
"boundary": "Different construction API and bounded instance/group counts.",
|
|
715
|
+
"implementation": [
|
|
716
|
+
"crates/agent-cad/src/assembly.rs",
|
|
717
|
+
"crates/agent-cad/src/step_assembly.rs"
|
|
718
|
+
],
|
|
719
|
+
"evidence": [
|
|
720
|
+
"crates/agent-cad/tests/assembly_tree.rs"
|
|
721
|
+
],
|
|
722
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
723
|
+
},
|
|
724
|
+
{
|
|
725
|
+
"id": "assembly-constraints",
|
|
726
|
+
"status": "partial",
|
|
727
|
+
"apis": [
|
|
728
|
+
"Assembly.constrain",
|
|
729
|
+
"Assembly.solve",
|
|
730
|
+
"Constraint"
|
|
731
|
+
],
|
|
732
|
+
"colocad": "Named attachments/datums and fixed/coincident/concentric/plane/distance/revolute/prismatic mates.",
|
|
733
|
+
"boundary": "Local solver and explicit direction/residual rules; CadQuery Axis/Plane names do not have identical semantics.",
|
|
734
|
+
"implementation": [
|
|
735
|
+
"crates/agent-cad/src/mates.rs",
|
|
736
|
+
"crates/agent-cad/src/solve.rs"
|
|
737
|
+
],
|
|
738
|
+
"evidence": [
|
|
739
|
+
"crates/agent-cad/tests/mates.rs",
|
|
740
|
+
"crates/agent-cad/tests/mates_alignment.rs"
|
|
741
|
+
],
|
|
742
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
743
|
+
},
|
|
744
|
+
{
|
|
745
|
+
"id": "appearance",
|
|
746
|
+
"status": "partial",
|
|
747
|
+
"apis": [
|
|
748
|
+
"Color"
|
|
749
|
+
],
|
|
750
|
+
"colocad": "Instance colors in Colocad preview/assembly metadata.",
|
|
751
|
+
"boundary": "No OCCT color class or full material/export appearance parity.",
|
|
752
|
+
"implementation": [
|
|
753
|
+
"crates/agent-cad/src/model.rs",
|
|
754
|
+
"crates/agent-cad/src/preview/mod.rs"
|
|
755
|
+
],
|
|
756
|
+
"evidence": [
|
|
757
|
+
"crates/agent-cad/tests/preview.rs"
|
|
758
|
+
],
|
|
759
|
+
"verification": "Representative Colocad contract tests; not CadQuery differential conformance"
|
|
760
|
+
}
|
|
761
|
+
]
|
|
762
|
+
}
|