buyun14 899af80c2f fix(automation): consume and report the tail of a batch command line
`run_command_line` feeds the tokens after the command verb to the interactive
command and then terminates it as if Enter were pressed. Two gaps left a
headless caller unable to tell what actually happened.

In-place text editor takes over, remaining tokens were dropped
----------------------------------------------------------------
The `TEXT` content step hands over to the in-place editor, at which point the
command has already ended (`active_cmd` is `None`). The feed loop stopped
there, so the rest of the line — including the text itself — vanished:
`TEXT 0,0 5 0 hello` reported `completed` with `added: 0` and created nothing.
The tail is now typed into that editor and committed, and the commit is done
synchronously so its result is observable: `text_inline_commit()` returning
false leaves the tokens in `unconsumed` instead of reporting a successful line.
Dispatch the commit as a queued message instead and a failed commit would look
exactly like a good one — the text dropped, `added: 0`, `unconsumed: []`.

Only an editor this line opens is taken over, and after a successful commit the
line is closed with an escape: `TEXT` re-arms for the next line
(`open_next_line`), which would otherwise let the *next* batch line be eaten as
the next text position.

Leftover tokens are dropped
---------------------------
Any token no prompt ever asked for is recorded in `CommandLine::unconsumed` and
surfaced by the automation `run` response, so over-typed or misplaced input is
visible instead of silently ignored: `CIRCLE 0,0 5 9` reports
`"unconsumed": ["9"]` while a fully consumed line reports an empty list.

Pending surfaces are reported instead of `completed`
----------------------------------------------------
`run` now carries `blocked_by` — `"command"`, `"text_editor"`,
`"mtext_editor"`, `"modal:<Kind>"`, or `null` — and answers `waiting_input`
when something is still open rather than claiming `completed`.

`blocked_by` is attributed to the line that opened the surface: a condition and
its snapshot are taken before the command runs, so an editor left open by an
earlier line, another tab, or a startup dialog does not turn a finished command
into `waiting_input`. Without that attribution a caller polling for `completed`
would wait forever on someone else's editor. `docs/automation` documented
`waiting_input` as "more input is required", which is exactly what a pending
surface is; the two new fields are documented there as well.

Tests
-----
* `batch_text_line_creates_text_and_consumes_every_token` — the regression case
  creates exactly one `Text` entity and leaves nothing unconsumed.
* `multi_word_text_keeps_the_spaces` — asserts the committed string, so an
  off-by-one in the consumed index or a wrong join cannot pass.
* `run_reports_leftover_tokens_instead_of_dropping_them`.
* `text_without_content_reports_the_open_editor`.
* `a_stray_editor_is_not_hijacked_by_the_next_line` — the next line neither
  types into the stray editor nor inherits its blocker (`blocked_by: null`,
  `status: completed`).
* `a_command_still_waiting_is_named_as_the_blocker`.

Verified over the `--serve` protocol: `TEXT 0,0 5 0 hello world` → `completed`,
`added: 1`, and the entity really holds `hello world`; `TEXT 40,0 5 0` →
`waiting_input` + `blocked_by: "text_editor"`; the following `CIRCLE 0,0 5 9` →
`completed`, `blocked_by: null`, `unconsumed: ["9"]`; `LINE` → `waiting_input`
+ `blocked_by: "command"`.

Full lib suite: 1497 passed, 2 failed — both failures
(`io::plot_style::…named_tables_and_missing_files_get_a_reason`,
`scene::parametric_constraints::…arc_grips_drive_center_start_and_end_but_not_midpoint`)
reproduce on the unmodified tree; run with `LC_ALL=C` since several xref tests
otherwise fail on a non-English locale.

Known remaining gap, unchanged here: `MTEXT` / `HATCH` still answer `completed`
with `added: 0` in this path (they need interactive surfaces the feeder has no
tokens to fill). Reported separately in #1390.
2026-09-20 19:15:55 +08:00
…
2026-08-22 09:33:38 +03:00

English · Български · Português (Brasil) · Čeština · Nederlands · Français · Suomi · Deutsch · Ελληνικά · Magyar · Italiano · 日本語 · 한국어 · Polski · Русский · 简体中文 · Español · 繁體中文 · Türkçe · हिन्दी · العربية

Open CAD Studio logo

Open CAD Studio

Open-source 2D drafting and 3D modeling for desktop and web, built with Rust.

Latest release Release downloads GitHub stars GPL-3.0 license

Launch the web app · Download the desktop app · Join the discussion

Open CAD Studio workspace

Overview

Open CAD Studio is a cross-platform application for technical drawing, layout work, and solid modeling. It reads and writes DWG and DXF drawings natively, with a shared editing core across the desktop and browser versions.

The project is under active development. Keep backups of important production drawings and report reproducible problems through GitHub Issues.

Highlights

  • Native drawing workflow — open, edit, recover, and save DWG and DXF files without a conversion service.
  • Precise 2D drafting — lines, polylines, curves, splines, hatches, object snaps, tracking, layers, blocks, and external references.
  • Documentation tools — text, dimensions, leaders, tolerances, tables, model space, paper space, viewports, and plot styles.
  • Kernel-backed 3D modeling — solid primitives, extrusion, revolution, sweep, loft, Boolean operations, and ACIS entity tessellation.
  • GPU rendering — accelerated 2D and 3D viewports through wgpu, with orthographic and perspective cameras.
  • Extensible workflows — native plugins, command scripts, headless conversion, and a line-based JSON automation API.

3D model in Open CAD Studio

File workflows

Format or workflow Support
DWG Read and write; versioned save targets from R14 through 2018
DXF Read and write; versioned save targets from R14 through 2018
BAK / SV$ Open drawing backups and autosave files
OBJ Import polygon meshes
LandXML Import CgPoint survey points
STL Export 3D mesh data
STEP AP203 Export 3D mesh data
PDF Plot layouts and selected geometry on desktop
CSV Extract entity property data
CTB / STB Load and edit plot style tables

Desktop or web

Use the web app for immediate access with no installation. Drawings are selected through the browser and saved as local downloads.

Use the desktop application for native file associations, file-manager thumbnails, system printing, PDF output, external plugins, command scripts, and headless automation. Release builds are available for Windows, Linux, and Apple Silicon macOS.

Install

Download all current packages from the latest release.

Windows

Choose one of these signed x86-64 packages:

  • OpenCADStudio-*-windows-x86_64-installer.msi — recommended installer with Start Menu shortcuts, DWG/DXF file associations, and drawing thumbnails.
  • OpenCADStudio-*-windows-x86_64-portable.exe — standalone application; no installation required.

Linux

Download the x86-64 AppImage, make it executable, and run it:

chmod +x OpenCADStudio-*-linux-x86_64.AppImage
./OpenCADStudio-*-linux-x86_64.AppImage

macOS

The published macOS package supports Apple Silicon:

  1. Download OpenCADStudio-*-macos-arm64.dmg.
  2. Open the image and drag OpenCADStudio.app into Applications.
  3. If Gatekeeper blocks the first launch, approve the app from System Settings → Privacy & Security.

The application is ad-hoc signed but is not currently notarized by Apple.

Languages

Open CAD Studio can follow the system language or use any of these 21 interface languages:

Arabic · Brazilian Portuguese · Bulgarian · Czech · Dutch · English · Finnish · French · German · Greek · Hindi · Hungarian · Italian · Japanese · Korean · Polish · Russian · Simplified Chinese · Spanish · Traditional Chinese · Turkish

Change the language from the application settings. The browser version also uses the browser's preferred locale when System is selected.

Build from source

Desktop

Requirements:

  • Git
  • Current stable Rust toolchain
  • Platform graphics and font development libraries

On Ubuntu or Debian, install the native dependencies with:

sudo apt update
sudo apt install libgl1-mesa-dev libx11-dev libxcursor-dev libxi-dev \
  libxrandr-dev libxkbcommon-dev libwayland-dev libfontconfig1-dev \
  libfreetype6-dev

Then build and run:

git clone https://github.com/HakanSeven12/OpenCADStudio.git
cd OpenCADStudio
cargo build --release --bin OpenCADStudio

The resulting binary is written to target/release/OpenCADStudio (OpenCADStudio.exe on Windows).

Web

Install the WebAssembly target and build tools once:

rustup target add wasm32-unknown-unknown
cargo install trunk wasm-bindgen-cli

Start the development server:

trunk serve

Automation

The desktop binary supports one-shot conversion, a persistent headless server, and a client-neutral MCP endpoint for AI applications:

OpenCADStudio --export input.dwg output.dxf
OpenCADStudio --serve
OpenCADStudio --serve --port 4242
OpenCADStudio --mcp

The automation server exchanges one JSON object per line over standard input/output or a local TCP socket. The self-contained MCP endpoint exposes the live desktop editor through the same tools to every compatible client. To connect a client, configure it to launch OpenCADStudio --mcp. See the MCP control guide.

Plugins

Desktop plugins run in separate processes and communicate with the host through the versioned plugin API. The browser build does not load native plugins.

Project documentation

Contributing

Bug reports, focused pull requests, translations, documentation improvements, and plugin contributions are welcome.

  • Search existing issues before opening a new report.
  • Use Discussions for questions and ideas.
  • Report vulnerabilities privately by following the security policy.

Application translations live in locales/*/opencadstudio.ftl; source labels map through src/locale_catalog.rs. After editing translations, run python3 scripts/export-locales.py to refresh web and desktop packaging labels. Validate with python3 scripts/test_site.py and cargo test --lib i18n::tests.

Project growth

Stars

Open CAD Studio star history

Release downloads

Open CAD Studio release download history

Support the project

If Open CAD Studio helps your work, support continued development through GitHub Sponsors or Patreon.

License

Open CAD Studio is distributed under the GNU General Public License v3.0.

S
Description
OneBSpace rebrand of OpenCADStudio -> OneCAD Draft (2D drafting / 3D modeling studio) + native Odoo Documents integration (open/save/write-back). Member of the OneCAD family. Upstream: opencadstudio-upstream. Addon: one_cad_draft.
Readme GPL-3.0
249 MiB
0 Stars 1 Watchers 0 Forks
Languages
Rust 70.8%
Fluent 27.8%
WGSL 0.5%
Python 0.3%
TypeScript 0.2%
Other 0.2%