simplecadapi 2.2.4__tar.gz → 2.2.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.2.4
+Version: 2.2.6
 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
@@ -226,6 +226,7 @@ Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Requires-Python: <3.14,>=3.10
 Requires-Dist: cadquery-ocp>=7.9.3.1
+Requires-Dist: cryptography>=42.0.0
 Requires-Dist: ezdxf>=1.4.4
 Requires-Dist: jsonschema<5.0.0,>=4.25.1
 Requires-Dist: marimo>=0.25.0
@@ -412,18 +413,20 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.4)
+## Update Notes (2.2.6)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **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.**
+- **Switch notebooks without leaving the CLI.** `sca cell open NOTEBOOK` moves the editor
+  and waits for its kernel; the write commands take `--open` to switch and write in one
+  step, and a refused write names the way out.
+- **`sca viewport` answers what the person sees.** The image's path, age and size, copied
+  out with `--out`, instead of reading `.sca-editor/viewport.png` by hand.
+- **Cache entries are signed and verified again.** `cryptography` ships as a dependency,
+  so marimo's cache verification no longer silently degrades to off.
 
-Full notes for this version: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md).
+Full notes for this version: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -444,7 +447,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.4`.
+Current release: `simplecadapi==2.2.6`.
 
 ## What It Provides
 
@@ -959,6 +962,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.6 update notes: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md)
+- 2.2.5 update notes: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md)
 - 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)

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

@@ -149,18 +149,20 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.4)
+## Update Notes (2.2.6)
 
 > Validate generated definitions, assembly constraints, and manufacturing
 > geometry before production use.
 
-- **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.**
+- **Switch notebooks without leaving the CLI.** `sca cell open NOTEBOOK` moves the editor
+  and waits for its kernel; the write commands take `--open` to switch and write in one
+  step, and a refused write names the way out.
+- **`sca viewport` answers what the person sees.** The image's path, age and size, copied
+  out with `--out`, instead of reading `.sca-editor/viewport.png` by hand.
+- **Cache entries are signed and verified again.** `cryptography` ships as a dependency,
+  so marimo's cache verification no longer silently degrades to off.
 
-Full notes for this version: [`docs/updates/2.2.4.md`](docs/updates/2.2.4.md).
+Full notes for this version: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -181,7 +183,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.4`.
+Current release: `simplecadapi==2.2.6`.
 
 ## What It Provides
 
@@ -696,6 +698,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 2.2.6 update notes: [`docs/updates/2.2.6.md`](docs/updates/2.2.6.md)
+- 2.2.5 update notes: [`docs/updates/2.2.5.md`](docs/updates/2.2.5.md)
 - 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)

{simplecadapi-2.2.4 → simplecadapi-2.2.6}/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.4
+  version: 2.2.6
   package-name: simplecadapi
-  package-version: 2.2.4
+  package-version: 2.2.6
 ---
 
 # SimpleCAD SDK Skill
@@ -50,9 +50,10 @@ Paths are relative to this file's directory.
   selected, and you MUST read
   `references/domains/editor-collaboration.md` first to see what they
   see (selection cell, `sca snapshot`, cell references) and how to
-  hand the work back. While the editor runs, change its notebooks with
-  `sca cell` (or the file; never both blindly): the editor is the
-  file's writer.
+  hand the work back. While the editor runs, `sca cell` is the only way to
+  change a regular cell; edit the file only when no editor is running, or
+  for the setup / `@app.function` cells `sca cell` refuses: the editor is
+  the file's writer.
 - Creating, installing, updating, or removing a SimpleCADAPI addon (a
   third-party skill+tooling package around `.scadpkg`) enters no
   workflow; you MUST use `references/domains/addon-development.md`
@@ -147,6 +148,13 @@ it and stop that route; never invent an alternative route.
     them in the editor for a person); never enable
     marimo's `[tool.marimo.runtime] cache_cells` in the editor, and
     never commit the generated `__marimo__/` directory.
+12. Manage the modeling project the way software is managed: put the
+    workspace under git from the first file, commit at verified
+    milestones (a passed verification, not a wall clock) with messages
+    that say what changed and why, and use a branch per design
+    direction when alternatives are on the table. Generated state —
+    `__marimo__/`, `.sca-editor/`, `out/` — belongs in `.gitignore`,
+    never in a commit.
 
 ## Boundaries
 

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

@@ -12,11 +12,17 @@ tuned value) is also something you can read from disk. Never rely on what the
 person says they selected when the file or the snapshot can tell you.
 
 The editor holds the open notebook in memory and is the one writer of its
-file. You have two safe ways to change it while it runs; use the first:
-
-1. **`sca cell` (preferred).** It edits through the editor: the page shows the
+file. While it runs, **`sca cell` is the only way to change a regular cell**:
+writing the file behind the editor's back races its next save, and the page's
+version or yours is lost. Edit the file directly only when no editor is
+running (then nothing else holds it), or for the cells `sca cell` refuses
+(the setup cell and `@app.function` cells): the editor takes those file
+changes in.
+
+1. **`sca cell` (always, for regular cells).** It edits through the editor: the page shows the
    change live (no reload, no flicker), the cell runs, and you get its state back.
-2. **Edit the file.** The editor notices a saved change within a second, compares
+2. **Edit the file** — only with no editor running, or for a setup / `@app.function` cell. The
+   editor notices a saved change within a second, compares
    it with its cells and applies only what differs (changed cells are edited in
    place and run again, added or removed cells appear or go away). A change to the
    setup cell or an `@app.function` cell restarts the kernel instead. A file that
@@ -57,6 +63,7 @@ echo 'L = 90' | sca cell put 3       # replace the code of cell 3 and run it (--
 sca cell insert --after 3 -f new.py  # add a cell (--after start|end|CELL, --name fn_name)
 sca cell rm 4
 sca cell run [CELL ...]              # run cells (default all) and what they feed
+sca cell open other.py               # have the editor open another notebook (waits for its kernel)
 sca new bracket --kind part          # a new notebook; the open editor lists it, the person's view stays
 ```
 
@@ -68,7 +75,8 @@ sca new bracket --kind part          # a new notebook; the open editor lists it,
   replaces the cell, so `get` first when the person may have changed it.
 - The commands find the running editor through `<workspace>/.sca-editor/server.json`. With no
   editor running, or with another notebook open, `ls` and `get` read the file and the write
-  commands refuse: then edit the file directly, nothing else holds it.
+  commands refuse: run `sca cell open NOTEBOOK` (or pass `--open` to switch and write in one
+  step), or edit the file directly, nothing else holds it.
 - `@app.function` cells cannot be changed this way; edit them in the file.
 
 ## Read what the person is doing
@@ -77,7 +85,7 @@ sca new bracket --kind part          # a new notebook; the open editor lists it,
 | --- | --- |
 | What is selected | the cell headed `# ---- selection ----` in the notebook file |
 | Everything at once (selection, cell states, errors, parameter values) | `sca snapshot [WORKSPACE]`, or `<workspace>/.sca-editor/snapshot.json` |
-| What the viewport looks like | `<workspace>/.sca-editor/viewport.png` (a PNG; look at it) |
+| What the viewport looks like | `sca viewport [WORKSPACE] [--out PATH]` — the PNG's path, age and size, copied out with `--out` (the file is `<workspace>/.sca-editor/viewport.png`) |
 | Which notebook is open | `notebook` in the snapshot |
 
 `sca snapshot` only has an answer while the editor runs; it reports the last

{simplecadapi-2.2.4 → simplecadapi-2.2.6}/docs/skill/references/domains/sketch-and-features.md

@@ -81,6 +81,10 @@ Read the exact page under `references/docs/api/` for every API used:
 ## Validation gates
 
 - Record plane mapping, closure, solve status, and remaining DOF in the brief.
+- `dof=0` says the constraint system closed, not that the shape is the intended
+  one: angle and symmetry constraints can solve to the mirror solution. Verify
+  the promoted geometry by measurement (bounding box, area, edge counts), never
+  by the solver status alone.
 - When sketch promotion may change measured geometry, build Wire and Sketch
   from one parameter source and compare closure/area/bounds/segmentation before
   promoting.

simplecadapi-2.2.6/docs/updates/2.2.5.md

@@ -0,0 +1,51 @@
+# 2.2.5 Update Notes
+
+From a container agent's field report: the editor now works the way agents actually use it,
+and says what happened instead of leaving silence.
+
+## `sca cell` works behind container proxies
+
+Before, a container's `http_proxy` swallowed the editor's health check and `sca cell`
+answered "no editor is running" while one was. Now the editor's discovery record always
+carries a loopback url (`--host 0.0.0.0` included), the checks bypass the proxy environment,
+and a record whose server does not answer is reported with its path and url instead of being
+skipped quietly. A record whose pid is gone says "stale record … delete it or restart the
+editor". When `sca cell ls`/`get` fall back to reading the file, they say so on stderr.
+
+## Cell feedback carries the chain
+
+`sca cell put/insert/run` now return the console output and every cell left unhealthy by the
+change, and the dependents a write made stale are run instead of waiting. A failing cell's
+report names its upstream cells (the failing ones first), so the error you see can be traced
+to its cause. A write whose rerun takes longer than the call now answers "the edit was
+applied and the rerun is still going; check `sca cell ls`" instead of a raw socket error
+(`SCA_EDITOR_CALL_TIMEOUT` raises the wait, default 300s).
+
+## Validate a stage headlessly
+
+```bash
+sca run stage.py --through 3 --no-product    # the first 3 cells, no product needed
+sca run stage.py --timeout 600               # a wall clock for heavy fillets
+```
+
+`--through N` runs the first N cells, numbered the way the editor numbers them; `--no-product`
+runs a work-in-progress notebook that has no product yet; `--timeout` fails a run that takes
+longer (off by default).
+
+## Quieter output, shorter prints
+
+The cache loaders' degraded-state warnings (unsigned entries, a value restored as a stub) no
+longer print at WARNING, and the render paths switch VTK's warning display off process-wide —
+this also hides VTK chatter from code you run in the same process. A real failure is still
+raised and named. Printing a `BRepInspection` shows a one-line summary; the per-face records
+are `to_dict()` / `.faces` / `.edges`.
+
+## Skill
+
+While an editor runs, `sca cell` is the only way to change a regular cell — the file only when
+no editor runs, or for the setup / `@app.function` cells `sca cell` refuses. `dof=0` says the
+constraint system closed, not that the shape is right (angle constraints can solve to the
+mirror solution): verify by measurement. And a modeling project is managed like software:
+git from the first file, commits at verified milestones.
+
+See the [changelog](../../CHANGELOG.md) for the complete list.

simplecadapi-2.2.6/docs/updates/2.2.5.zh-CN.md

@@ -0,0 +1,41 @@
+# 2.2.5 更新说明
+
+来自容器 agent 的实战复盘：编辑器现在按 agent 真实的使用方式工作，并且把发生的事说出来，而不是留下沉默。
+
+## `sca cell` 在容器代理后面也能找到编辑器
+
+以前容器的 `http_proxy` 会吞掉编辑器的健康检查，`sca cell` 在编辑器明明运行时回答"no editor is running"。
+现在编辑器的发现记录始终携带回环地址（`--host 0.0.0.0` 也是），检查绕过代理环境，应答不了的服务器记录会带着
+路径和 url 报出来，而不是被悄悄跳过。pid 已消失的记录会说"stale record … delete it or restart the editor"。
+`sca cell ls`/`get` 降级读文件时会在 stderr 上说明。
+
+## cell 反馈带着整条链
+
+`sca cell put/insert/run` 现在返回 console 输出和这次修改留下的每一个不健康的 cell，写操作导致的 stale 依赖
+会被运行而不是晾着。出错 cell 的报告会列出它的上游 cell（先列出同样在报错的），让错误能追溯到根因。重跑超出
+调用时长的写操作现在回答"the edit was applied and the rerun is still going; check `sca cell ls`"而不是裸的
+socket 错误（`SCA_EDITOR_CALL_TIMEOUT` 可加大等待，默认 300 秒）。
+
+## 按阶段做无头校验
+
+```bash
+sca run stage.py --through 3 --no-product    # 只跑前 3 个 cell，不需要产品
+sca run stage.py --timeout 600               # 给重 fillet 一个墙上时钟
+```
+
+`--through N` 只跑前 N 个 cell（按编辑器的编号方式计）；`--no-product` 运行还没有产品的半成品 notebook；
+`--timeout` 让超时的运行失败（默认不限时）。
+
+## 更安静的输出、更短的打印
+
+缓存加载器的降级警告（未签名的条目、以 stub 恢复的值）不再以 WARNING 打印，渲染路径进程级关闭 VTK 的警告
+显示——同一进程里你自己代码的 VTK 警告也会被隐藏。真正的失败仍然会大声报出并点名。打印 `BRepInspection`
+现在是一行摘要；逐面记录在 `to_dict()` / `.faces` / `.edges`。
+
+## Skill
+
+编辑器运行时，`sca cell` 是修改普通 cell 的唯一方式——直接改文件只在没有编辑器运行时，或用于 `sca cell`
+拒绝的 setup / `@app.function` cell。`dof=0` 说明约束系统闭合了，不说明形状是对的（角度约束可能解出镜像
+解）：用测量来验证。建模项目按软件工程的方式管理：从第一个文件就用 git，在验证通过的节点提交。
+
+完整列表见[更新日志](../../CHANGELOG.md)。

simplecadapi-2.2.6/docs/updates/2.2.6.md

@@ -0,0 +1,44 @@
+# 2.2.6 Update Notes
+
+From the same field report as 2.2.5, the follow-up: an agent working a
+multi-notebook workspace no longer has to leave the CLI to keep working — and the
+cache it relies on is verified again.
+
+## Switch notebooks without leaving the CLI
+
+An agent editing `l_link.py`, `l_link_shell.py`, and an assembly had exactly one way
+to move the editor between them: a raw `curl` to `/api/workspace/open`, an endpoint
+found by reading the installed server's source — because a write refuses while
+another notebook is open, and no command could switch. Now:
+
+```bash
+sca cell open other.py        # the editor switches; waits for the kernel to boot
+echo '...' | sca cell put 3 --open   # switch and write in one step
+```
+
+`sca cell open` waits until the switched notebook's kernel is up
+(`SCA_EDITOR_OPEN_WAIT` or `--wait`, default 120s), so the following write does not
+race the boot. Re-asking for the notebook that is already open and ready does not
+restart the kernel. A refused write names the command as the remedy, and
+`/api/cells` reports `kernel` so a caller can tell a booted notebook from one whose
+name has flipped while the kernel still boots.
+
+## See the viewport as a command
+
+```bash
+sca viewport --out /tmp/seen.png     # path, age in seconds, size; copied out
+```
+
+The image of what the person sees is now `sca viewport`'s answer instead of a
+`.sca-editor/viewport.png` file agents had to know about and read by hand. The age
+says how fresh the view is; there is no image until the page showed a model at
+least once.
+
+## Cache entries are signed and verified again
+
+The notebook cache is marimo's `LazyLoader`, whose verification is on by default:
+without the `cryptography` package it degraded to off and every run warned that
+cache entries were neither signed nor verified. `cryptography` ships as a
+dependency now, so verification stays on everywhere the cache works.
+
+See the [changelog](../../CHANGELOG.md) for the complete list.

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

@@ -0,0 +1,39 @@
+# 2.2.6 更新说明
+
+和 2.2.5 来自同一份实地报告的续篇：agent 在多 notebook 工作区里干活，不用再绕开 CLI
+才能继续——它依赖的缓存也重新有了签名验证。
+
+## 不离开 CLI 就能切换 notebook
+
+一个 agent 要同时编辑 `l_link.py`、`l_link_shell.py` 和一个装配体，把编辑器在它们之间
+切换的办法只有一个：对着 `/api/workspace/open` 发裸 `curl`——这个端点是它读了安装包里
+server 的源码才找到的，因为编辑器开着别的 notebook 时写入会被拒绝，而没有任何命令能切换。
+现在：
+
+```bash
+sca cell open other.py        # 编辑器切换过去；等 kernel 启动完成
+echo '...' | sca cell put 3 --open   # 切换 + 写入一步完成
+```
+
+`sca cell open` 会等到切换后的 notebook kernel 就绪（`SCA_EDITOR_OPEN_WAIT` 或
+`--wait`，默认 120s），后续写入不会和启动赛跑。对已经打开且就绪的 notebook 再次执行
+不会重启 kernel。写入被拒绝时报错会直接给出这条命令，`/api/cells` 也会报告 `kernel`，
+让调用方分得清"名字已切换"和"kernel 还在启动"。
+
+## 像命令一样拿视口图
+
+```bash
+sca viewport --out /tmp/seen.png     # 路径、age（秒）、大小；复制出来
+```
+
+"用户现在看到什么"的图，现在是 `sca viewport` 的输出，而不是一个要 agent 自己知道、
+自己读的 `.sca-editor/viewport.png` 文件。age 说明画面有多新鲜；页面从未显示过模型时
+没有图。
+
+## 缓存条目重新有了签名验证
+
+notebook 缓存是 marimo 的 `LazyLoader`，默认开着验证：缺 `cryptography` 包时会降级关
+闭，每次运行都警告"cache entries are neither signed nor verified"。现在 `cryptography`
+作为依赖随包安装，缓存能工作的地方验证就开着。
+
+完整清单见[更新日志](../../CHANGELOG.md)。

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

@@ -1,6 +1,6 @@
 [project]
 name = "simplecadapi"
-version = "2.2.4"
+version = "2.2.6"
 description = "A simplified OCP-native CAD modeling Python API"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -35,6 +35,7 @@ dependencies = [
     "ezdxf>=1.4.4",
     "marimo>=0.25.0",
     "plotly>=7.1.0",
+    "cryptography>=42.0.0",
 ]
 
 [project.optional-dependencies]

{simplecadapi-2.2.4 → simplecadapi-2.2.6}/src/simplecadapi/cli.py

@@ -12,6 +12,7 @@ Groups, each owned by its module and registered here at parser level so
     sca edit [WORKSPACE]          # the web editor (needs the 'editor' extra)
     sca example [NAME] [DIR]      # copy a bundled example workspace out
     sca snapshot [WORKSPACE]      # what the editor user has selected / sees
+    sca viewport [WORKSPACE]      # the image of what the editor user sees
 
 Shared contract: group handlers return ``(report, exit_code)`` and are
 followed by the group's own printer (human-readable for init/addon, JSON