simplecadapi 2.2.3__tar.gz → 2.2.4__tar.gz

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.2.3
+Version: 2.2.4
 Summary: A simplified OCP-native CAD modeling Python API
 Project-URL: Homepage, https://github.com/PhySpace/SimpleCADAPI
 Project-URL: Repository, https://github.com/PhySpace/SimpleCADAPI
@@ -412,20 +412,18 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.3)
+## Update Notes (2.2.4)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **The editor takes in edits made to the notebook file.** An agent's saved change is applied
-  cell by cell (changed cells update and run again, no reload), and is no longer written over by
-  the editor. If a cell was edited in both places, the file's version is kept and your unsaved
-  text goes to the log. Notebooks added to the workspace appear in the list by themselves.
-- **`sca cell` and `sca new`.** `sca cell ls|get|put|insert|rm|run` edits the open notebook's cells
-  through the running editor (the page updates live, each write prints the cell's status and
-  errors); `sca new NAME` creates a notebook the editor then lists.
+- **The editor tells you why no model is coming.** A failed build is reported on every run you or
+  an agent asks for (rerun, `sca cell`, a file change, a module reload), and to a page that opens
+  or refreshes afterwards — the "building the model" veil lifts with the reason instead of
+  waiting out its fallback.
+- **The header's jump-to-marimo button is gone.**
 
-Full notes for this version: [`docs/updates/2.2.3.md`](docs/updates/2.2.3.md).
+Full notes for this version: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -446,7 +444,7 @@ in a compact public API for creating solids, applying features, tagging semantic
 intent, querying topology, exporting manufacturing files, and translating recorded
 models into FreeCAD workflows.
 
-Current release: `simplecadapi==2.2.3`.
+Current release: `simplecadapi==2.2.4`.
 
 ## What It Provides
 
@@ -961,6 +959,7 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.4 update notes: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md)
 - 2.2.3 update notes: [`docs/updates/2.2.3.md`](docs/updates/2.2.3.md)
 - 2.2.2 update notes: [`docs/updates/2.2.2.md`](docs/updates/2.2.2.md)
 - 2.2.1 update notes: [`docs/updates/2.2.1.md`](docs/updates/2.2.1.md)

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/README.md

@@ -149,20 +149,18 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.3)
+## Update Notes (2.2.4)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **The editor takes in edits made to the notebook file.** An agent's saved change is applied
-  cell by cell (changed cells update and run again, no reload), and is no longer written over by
-  the editor. If a cell was edited in both places, the file's version is kept and your unsaved
-  text goes to the log. Notebooks added to the workspace appear in the list by themselves.
-- **`sca cell` and `sca new`.** `sca cell ls|get|put|insert|rm|run` edits the open notebook's cells
-  through the running editor (the page updates live, each write prints the cell's status and
-  errors); `sca new NAME` creates a notebook the editor then lists.
+- **The editor tells you why no model is coming.** A failed build is reported on every run you or
+  an agent asks for (rerun, `sca cell`, a file change, a module reload), and to a page that opens
+  or refreshes afterwards — the "building the model" veil lifts with the reason instead of
+  waiting out its fallback.
+- **The header's jump-to-marimo button is gone.**
 
-Full notes for this version: [`docs/updates/2.2.3.md`](docs/updates/2.2.3.md).
+Full notes for this version: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -183,7 +181,7 @@ in a compact public API for creating solids, applying features, tagging semantic
 intent, querying topology, exporting manufacturing files, and translating recorded
 models into FreeCAD workflows.
 
-Current release: `simplecadapi==2.2.3`.
+Current release: `simplecadapi==2.2.4`.
 
 ## What It Provides
 
@@ -698,6 +696,7 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.4 update notes: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md)
 - 2.2.3 update notes: [`docs/updates/2.2.3.md`](docs/updates/2.2.3.md)
 - 2.2.2 update notes: [`docs/updates/2.2.2.md`](docs/updates/2.2.2.md)
 - 2.2.1 update notes: [`docs/updates/2.2.1.md`](docs/updates/2.2.1.md)

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/docs/skill/SKILL.md

@@ -4,9 +4,9 @@ description: Build, assemble, inspect, reconstruct, and export parametric CAD mo
 license: Apache-2.0
 metadata:
   project: simplecadapi
-  version: 2.2.3
+  version: 2.2.4
   package-name: simplecadapi
-  package-version: 2.2.3
+  package-version: 2.2.4
 ---
 
 # SimpleCAD SDK Skill

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/docs/skill/references/docs/guides/notebook-runtime.md

@@ -167,7 +167,11 @@ sca ls [DIR]                 # the notebooks under DIR: id, part or assembly, th
 ```
 
 A **workspace** is any directory tree: its models are the notebooks whose
-header has `[tool.simplecadapi]`, wherever they are. There is no manifest.
+header has `[tool.simplecadapi]`, at any depth. There is no manifest. Skipped
+everywhere: names starting with `.` or `_`, and `node_modules`, `venv`,
+`site-packages`, `build`, `dist` — a notebook in such a place is not listed
+by `sca ls` or the editor's workspace tab, so keep notebooks in normally
+named paths.
 
 `sca edit [WORKSPACE]` (needs `pip install "simplecadapi[editor]"`) opens a
 code-first editor on a workspace. The notebooks run in a marimo kernel with

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/docs/skill/references/domains/editor-collaboration.md

@@ -35,9 +35,14 @@ sca edit <workspace> --no-browser --port 7180
 
 - Needs the `editor` extra (`pip install "simplecadapi[editor]"`); without it
   the command says so and stops.
-- The workspace is any directory tree. Models are the notebooks whose header has
-  `[tool.simplecadapi]`; assemblies list the parts they `use(...)`. Open the
-  assembly to see the product, a part to edit that part.
+- The workspace is any directory tree, scanned to any depth. Models are the
+  notebooks whose header has `[tool.simplecadapi]`; assemblies list the parts
+  they `use(...)`. Open the assembly to see the product, a part to edit that
+  part. Working in a subfolder is fine; what hides a file from the workspace
+  tab is its name: directories and files starting with `.` or `_`, and
+  anything under `node_modules`, `venv`, `site-packages`, `build` or `dist`,
+  are not listed and are never a candidate at boot. Keep notebooks and the
+  modules they import in normally named paths.
 - The URL is printed (default `http://127.0.0.1:7180`). Give it to the person.
 - To try it: `sca example u_link` copies a motor-mount workspace (two parts and
   the assembly that fixes them together) to `./u_link_motor_mount`, then

simplecadapi-2.2.4/docs/updates/2.2.4.md

@@ -0,0 +1,23 @@
+# 2.2.4 Update Notes
+
+The editor now tells you why no model is coming, instead of showing "building the model" until
+its fallback clears.
+
+## A failed build is reported every time you ask for one
+
+Before, a publish error was reported once per identical message. When the same failure repeated —
+you press "run all" again, an agent edits a cell, the notebook file changes on disk — the editor
+stayed silent: no model arrived, no error was shown, and the page waited out its three-minute
+fallback. Now every run someone asks for reports its outcome afresh, and the veil lifts with the
+reason (for example, a notebook whose top-level Part does not carry the notebook id; the message
+ends with the Parts and Assemblies that were found instead). Reports during a slider drag are
+still collapsed to one per identical state.
+
+A page that opens or refreshes after the failure learns the reason at once, from the end of the
+connection handshake.
+
+## The marimo button
+
+The header's button that opened the raw marimo editor is gone.
+
+See the [changelog](../../CHANGELOG.md) for the complete list.

simplecadapi-2.2.4/docs/updates/2.2.4.zh-CN.md

@@ -0,0 +1,19 @@
+# 2.2.4 更新说明
+
+编辑器现在会告诉你模型为什么没出来，而不是让"building the model"一直挂到兜底超时。
+
+## 每次主动运行都会报告构建结果
+
+以前同一条发布错误只报一次。当同样的失败再次出现时——再点一次"run all"、agent 改了一个 cell、
+notebook 文件在磁盘上被修改——编辑器会保持沉默：模型不来，错误也不显示，页面只能等三分钟兜底。
+现在每一次主动发起的运行都会重新报告结果，遮罩会随原因揭开（例如 notebook 顶层 Part 的 id 和
+notebook id 不匹配；报错末尾会列出实际找到的 Parts and Assemblies）。拖 slider 过程中的重复
+报告仍然按同状态折叠成一条。
+
+在失败之后打开或刷新的页面，会在连接握手的末尾立刻拿到这条原因。
+
+## marimo 按钮
+
+顶栏里跳转到 marimo 原生编辑器的按钮已移除。
+
+完整列表见[更新日志](../../CHANGELOG.md)。

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplecadapi"
-version = "2.2.3"
+version = "2.2.4"
 description = "A simplified OCP-native CAD modeling Python API"
 readme = "README.md"
 license = { file = "LICENSE" }

{simplecadapi-2.2.3 → simplecadapi-2.2.4}/src/simplecadapi/editor/server.py

@@ -642,6 +642,7 @@ class WorkspaceState:
         kernel = self.kernel
         if kernel is None:
             return {"error": "the editor has no kernel yet; wait for it to start"}
+        self._begin_run()
         self.push_cells()
         touched: list[str] = []
         try:
@@ -691,6 +692,7 @@ class WorkspaceState:
         return report
 
     def _rerun_changed(self, kernel: MarimoKernel, changed: list[str]) -> None:
+        self._begin_run()
         kernel.run_until_settled(changed)
         self.schedule_settle()
 
@@ -758,6 +760,7 @@ class WorkspaceState:
                     if not uses:
                         continue
                     kernel.run_until_settled(uses)
+                self._begin_run()
                 self.schedule_settle()
         except Exception as exc:
             with self._module_lock:
@@ -881,6 +884,17 @@ class WorkspaceState:
             "marimo_url": self.kernel.marimo_url if self.kernel else None,
         }
 
+    def settled_error(self) -> dict | None:
+        """The publish error of the last settle, for a page that connects late.
+
+        ``status`` envelopes are momentary and not replayed, but a page that
+        refreshes after a failed publish must still learn why no model is
+        coming — its veil only lifts on a ``preview`` or an error.
+        """
+        if not self._last_publish_error:
+            return None
+        return {"type": "status", "error": self._last_publish_error[-300:]}
+
     # -- settling: the cells ran; publish what they made -----------------------
 
     def schedule_settle(self) -> None:
@@ -931,6 +945,18 @@ class WorkspaceState:
                 self._last_publish_error = message
                 self.hub.broadcast({"type": "status", "error": message[-300:]})
 
+    def _begin_run(self) -> None:
+        """Cells are about to run because someone asked for it: report afresh.
+
+        The dedup above is for the parameter burst, where a product-less
+        notebook would repeat the same line on every slider tick.  A discrete
+        run (a page command, an agent edit, a file change) is a new question:
+        its failure must be told even if it repeats the last error word for
+        word, or the page waits out its whole veil for an answer that never
+        comes.
+        """
+        self._last_publish_error = ""
+
     @property
     def preview_url(self) -> str:
         return f"http://127.0.0.1:{self.port}/api/runtime/preview"
@@ -1111,6 +1137,7 @@ class WorkspaceState:
             return {"type": "error", "message": f"unknown command: {kind}"}
 
         def run() -> None:
+            self._begin_run()
             result = action()
             if result.get("success") is False:
                 self.hub.broadcast(
@@ -1265,6 +1292,7 @@ class WorkspaceState:
         write_saved_params(config, saved)
         if revert:
             kernel.run_until_settled([self.specs[name].cell for name in names if name in self.specs])
+        self._begin_run()
         self.schedule_settle()
 
     # -- selection and the agent snapshot ----------------------------------------
@@ -1801,6 +1829,9 @@ def create_app(state: WorkspaceState) -> Starlette:
         await websocket.send_json(state.hello())
         for envelope in state.replay():
             await websocket.send_json(envelope)
+        settled = state.settled_error()
+        if settled is not None:
+            await websocket.send_json(settled)
         try:
             while True:
                 message = await websocket.receive_json()