feat(task-7): SECTION 21 - the mechanical part model as six tools

engineering/mech/draw.py is the only module in the package that touches a
backend: it turns the pure engine's primitive descriptions into entity_create_*
and dimension_* calls, places them in WCS, and writes the part model back onto
the drawing as ACADMCP_MECH XDATA on an anchor POINT. It is not a contract
member and neither are the tools - exactly like gear_draw_* and
titleblock_apply_iso_a3, it composes the generic members, so it is written once
and works on both engines by construction and no capability key is needed. No
new ActiveX call was written, so there was nothing to probe on the live seat;
measured instead that every one of the 23 backend members draw.py calls exists
on ComBackend and that ComBackend has no abstract methods left.

mech_part_draw takes one model - a turned profile or a plate outline plus typed
features - and draws its views in first-angle positions (third on request),
dimensions them and records the placement. mech_view_add reads the model back
out of the drawing and adds a side, top, section (full/half/offset/revolved) or
detail view months later without the caller re-describing the part.
mech_dimension_part lays out ISO 129 dimensions with no overlapping text,
resolves ISO 286 fits against the measured nominal, and moves the holes into a
table past a threshold. mech_hole_pattern exposes the same expansion for a
drawing that was never built from the model - with its own diameter guard,
because Hole.validate needs a part and a standalone pattern has none.
mech_part_inspect reads the payload back and never modifies the drawing.

mech_part_from_spec draws a whole sheet inside one transaction. Every part is
validated before the transaction opens, so a refusal leaves the drawing
untouched and names the path (parts[1]: segments[0].d_outer: ...), and the
rollback is shielded with the shape engineering/pid/spec.py documents: anyio
cancellation is level-triggered, so a bare await in the handler would be
cancelled before the rollback body ran and leave half a sheet inside an open
transaction.

fits goes through dimension_intents(fits=...), the API Task 6 shipped, rather
than being stamped on at draw time: that is the path that validates a key by
name and refuses a fit on a reference dimension or on a hole that moved into
the table. It is scoped per view first - a fit on segment[0] names nothing in
the end view, and refusing there would make a correct three-view sheet
undrawable - and any key no view claimed is handed back to dimension_intents so
the refusal is written in its own vocabulary.

SECTION 21 registers the six tools in the new mech pack, with alias records
(SECTIONPLANE, ARRAY plus shop-floor synonyms in English and Turkish - mil,
kademeli mil, kama, pah, kesit, gorunus), a regenerated tool inventory, the
README release snapshot at 210 tools in 24 groups, and the frozen group-size
snapshot gaining mech: 6. Lean is deliberately untouched here: spec section 11
puts three of these on the lean surface together with group G's two sheet tools,
and Task 15 makes that edit once across all four branches.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FKFStjEFzpGyLq5bMpWxTd
This commit is contained in:
Umut CAN
2026-09-22 23:17:29 +03:00
co-authored by Claude Opus 5
parent bd73b3a854
commit 8b14d4ef8d
9 changed files with 1722 additions and 13 deletions
+90
View File
@@ -1859,6 +1859,96 @@ TOOL_ALIASES: dict[str, ToolAliases] = {
"save a detail view",
),
),
# ── Mechanical parts (SECTION 21, tracks B+G group M) ───────────────────
"mech_part_draw": ToolAliases(
acad=(),
synonyms=(
"draw a shaft",
"stepped shaft",
"draw a machine part",
"turned part",
"draw a plate",
"flange",
"part from a segment list",
"shaft with a keyway",
"mil",
"mil ciz",
"kademeli mil",
"kama",
"pah",
"plaka",
"flans",
),
),
"mech_view_add": ToolAliases(
acad=("SECTIONPLANE",),
synonyms=(
"add a section view",
"section a-a",
"cross section",
"half section",
"offset section",
"detail view",
"blown-up detail",
"end view",
"side view",
"another view of the part",
"kesit",
"kesit al",
"gorunus",
"yan gorunus",
"detay",
),
),
"mech_dimension_part": ToolAliases(
acad=(),
synonyms=(
"dimension the part",
"put the dimensions on",
"chain dimensions",
"baseline dimensions",
"ordinate dimensions",
"hole table",
"iso 286 fit on a dimension",
"h7 bore",
"olculendir",
"olcu ver",
"tolerans",
),
),
"mech_hole_pattern": ToolAliases(
acad=("ARRAY",),
synonyms=(
"bolt circle",
"hole pattern",
"hole array",
"pitch circle of holes",
"grid of holes",
"delik deseni",
"civata dairesi",
"delik aynasi",
),
),
"mech_part_from_spec": ToolAliases(
acad=(),
synonyms=(
"draw the whole sheet",
"several parts at once",
"mechanical sheet from a spec",
"batch draw parts",
"parca sayfasi",
),
),
"mech_part_inspect": ToolAliases(
acad=(),
synonyms=(
"what part is this",
"read the part model back",
"part features",
"which views were drawn",
"parca bilgisi",
),
),
}