feat(graph): graph-select verb + convexity in graph-ml (closes #54, #55)

[gsdali]

Implements the two self-contained BRepGraph coverage gaps from the audit — the selection / "pointer" primitives the generative-CAD literature (UV-Net, Pointer-CAD, AAGNet) relies on.

#54 — graph-select verb

Answers a local topology question without exporting + re-parsing the whole graph (graph-ml):

query	returns
--query face-neighbors --face N	faces adjacent to face N, each with convexity + shared-edge count, plus the face's planar/vertical/horizontal/normal attrs
--query edge-faces --edge M	the edge's faces, start/end vertices, boundary + manifold flags
--query vertex-edges --vertex K	edges incident to vertex K
--query face-adjacency	the full attributed face-adjacency graph (gAAG)
--query edges-class --class boundary|non-manifold|seam|degenerate	matching edge indices

Backed by the kernel AAG (face queries / convexity) and TopologyGraph (edge/vertex adjacency).

#55 — convexity-attributed face-adjacency in graph-ml

graph-ml now emits a faceAdjacency block — [{face1, face2, convexity, sharedEdgeCount}] from the AAG. Convexity is the top edge feature in B-rep GNNs (the gAAG attribute used by AAGNet/BRepGAT) and is exactly what concave/convex selectors resolve; it was previously absent from the export.

Index spaces

Face queries use AAG indices (= shape.faces() order = the face[N] scheme query-topology emits). Edge/vertex queries use TopologyGraph indices (edge[M]/vertex[K]). Convexity is a dihedral-between-two-faces property, so it's reported on face adjacencies, not lone edges — documented in the verb header.

Verification

swift build clean. Smoke-tested on recipes/01-mounting-bracket (a filleted L-bracket): 20 faces / 38 adjacencies; the filleted inner corner classifies concave and outer edges convex as expected; a watertight solid reports 0 boundary edges.

Also carries the earlier OKF knowledge-bundle docs commit (docs/knowledge/) that was sitting on local main.

The MCP-side mirror of these (graph_select / convexity passthrough on scene bodies) is OCCTMCP#38, which depends on this landing + a release.

🤖 Generated with Claude Code