From f0c50d772fca5f97d6281b15248da83710364acb Mon Sep 17 00:00:00 2001 From: Umut CAN Date: Thu, 24 Sep 2026 11:30:38 +0300 Subject: [PATCH] docs(spec,plan): track H states what it does with xrefs The spec promised that the first live task would measure xrefs. It never did: the plan measures model space, paper space and block definitions. 1.6 does not read an xref's own entities on either engine; the host drawing is what gets read. The snapshot docstring and drawing_understand's docstring now say so, and nothing is claimed about the live engine that was never measured. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01FKFStjEFzpGyLq5bMpWxTd --- .../plans/2026-09-24-v1.6-understand-implementation.md | 6 +++++- docs/superpowers/specs/2026-09-24-v1.6-understand-design.md | 5 +++-- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/superpowers/plans/2026-09-24-v1.6-understand-implementation.md b/docs/superpowers/plans/2026-09-24-v1.6-understand-implementation.md index 2895109..0cad1a5 100644 --- a/docs/superpowers/plans/2026-09-24-v1.6-understand-implementation.md +++ b/docs/superpowers/plans/2026-09-24-v1.6-understand-implementation.md @@ -1951,7 +1951,10 @@ Where the snapshot comes from: - **the selection set does not narrow a DXF export**: an empty selection set wrote the same model space, paper space and blocks as the set of all. The set of all is passed anyway, because the ActiveX signature requires one. - - xrefs were not measured. + - xrefs were not measured, so nothing is claimed for the live engine; + headless, ezdxf reads the host file only. Either way an xref's own + entities are not read in 1.6 - the host drawing is - and + ``drawing_understand``'s docstring says so. A DWG path on the live engine is opened read-only, exported the same way and closed without saving. @@ -5506,6 +5509,7 @@ async def drawing_understand( and a confidence. Never modifies the drawing: a file is read as it is, and the current document through a snapshot (headless: the document in memory; live: a `Document.Export` DXF copy in a temporary folder, deleted after). + An xref's own entities are not read - the host drawing is. - `units`: `$INSUNITS` as declared against the unit the geometry implies (text heights, wall thickness, door swings, labelled room areas, overall diff --git a/docs/superpowers/specs/2026-09-24-v1.6-understand-design.md b/docs/superpowers/specs/2026-09-24-v1.6-understand-design.md index 706ee98..07622f5 100644 --- a/docs/superpowers/specs/2026-09-24-v1.6-understand-design.md +++ b/docs/superpowers/specs/2026-09-24-v1.6-understand-design.md @@ -98,8 +98,9 @@ handle, geometry, text, block name, attributes) filled once per drawing, so a exported too, and ezdxf read the result. The extension argument must be `"DXF"`; `".dxf"` fails with *Invalid argument* (measured). The snapshot goes to a temporary folder and is deleted afterwards. Whether paper-space content - and xrefs reach the snapshot is measured by the plan's first live task and - stated in the tool docstrings. + reaches the snapshot is measured by the plan's first live task and stated in + the tool docstrings. An xref's own entities are not read in 1.6 on either + engine - the host drawing is - and `drawing_understand`'s docstring says so. - `MAX_DXF_BYTES` default rises from 50 MB to 512 MB, and the refusal names the size and the variable (a real layout here was 188 MB).