Skip to content

An honest tool list: remove 33 planned tools, deprecate 8 duplicates, a verb list - #229

Merged
andrewbartels1 merged 6 commits into
mainfrom
feat/honest-tool-list
Nov 15, 2026
Merged

andrewbartels1 merged 6 commits into
mainfrom
feat/honest-tool-list

Conversation

@andrewbartels1

Copy link
Copy Markdown
Owner

Closes #174. Every registered tool now either works or is one of seven drawing tools the drawing pack builds; duplicates are deprecated for one release; new tools follow one verb list.

What changed

  • 33 planned tools removed. Each only ever returned not_supported. Why each went, and what does its job now, is in openspec/queue.md ("Removed tools"). Two real gaps it found are queued as items 20 (elastic material properties) and 21 (save as template).
  • manage_design_table removed after a live check (below): design tables don't work through COM on SolidWorks 2026 here.
  • A deprecated support level. Eight duplicates still work until 3.0.0; their description and successful results say "Deprecated: use <tool>.": load_part, load_assembly → open_model; save_part, save_assembly → save_file; calculate_mass_properties → get_mass_properties; get_file_properties → get_model_info; add_drawing_view → create_drawing_view; sketch_tutorial_simple_hole → none. The levels check fails once the major version passes the one each was deprecated in.
  • save_file checks a new path before SolidWorks is asked (folder exists and is writable, extension matches the document, no overwrite unless overwrite). It used to replace an existing file silently.
  • get_model_info reports the file's size and dates.
  • A verb list for tool names in the description standard, checked in tests; older names that break it are listed as exceptions, not renamed. A new check fails if a description names a tool that doesn't exist.
  • Docs: the tools overview rewritten from the real families (most of the old page described tools that never existed), catalog pages and every count updated (123 tools; 115 in the progress image, which leaves out the deprecated ones), the agent skill points at the replacements.

Live checks (SolidWorks 2026)

All in tests/live/test_live_sw_honest_tool_list.py, run one per process with tests/scripts/live_demo.ps1.

Check Result
save_file to a new path saved, file on disk
... into a folder that doesn't exist invalid_input, names the folder, nothing written
... block.SLDASM for a part invalid_input: "file_path must end in .sldprt"
... onto an existing file invalid_input, kept; replaced with overwrite: true
get_model_info on a saved part size_bytes 58,010 and its dates
... on a new, unsaved part empty path, nulls, call succeeds
load_part (deprecated) opens the part; warning: "Deprecated: use open_model."
Design-table probe InsertFamilyTableOpen adds a table, but IDesignTable.Attach is false, row and column counts are -2, and no configuration is made → manage_design_table removed

Checks

  • Mock suite: 3,792 passed, 100% coverage; ruff clean; mkdocs build --strict; openspec validate --all.

andrewbartels1 and others added 6 commits November 14, 2026 17:49
…8 duplicates, a verb list

- New support level 'deprecated': description and success warning name the
  replacement; the levels check fails once the major version passes 'since'.
- Planned tools name the queue item that builds them (7 drawing tools, and
  manage_design_table until its live probe decides).
- save_file checks a new path (folder, extension, overwrite); get_model_info
  reports the file's size and dates.
- Verb list in the tool description standard, checked in the description test,
  plus a check that no description names a tool that doesn't exist.
- Docs: tools overview rewritten from the real families, catalog pages and
  counts updated, skill guidance points at the replacements.
…don't work through COM here)

On SolidWorks 2026 with Excel installed, InsertFamilyTableOpen adds the
table but IDesignTable.Attach is false, the counts are -2 and no
configuration is made. Removed with the other planned tools (33 in all);
seven planned drawing tools remain. Finding recorded in the honest-tool-list
design and the configuration-tools plan.
@andrewbartels1
andrewbartels1 merged commit 0403bdb into main Nov 15, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore(tools): consolidate duplicate and overlapping tools

1 participant