simplecadapi 2.2.3__tar.gz → 2.2.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.2.3
+Version: 2.2.5
 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,21 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.3)
+## Update Notes (2.2.5)
 
 > 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.
+- **`sca cell` works behind container proxies.** The editor's discovery record is loopback and
+  proxy-proof, an unreachable record is reported instead of silently ignored, and file
+  fallbacks say so on stderr.
+- **Cell feedback carries the chain.** put/insert/run return console output and every cell
+  left unhealthy, stale dependents are run, and a failing cell names its upstream.
+- **Validate a stage headlessly.** `sca run --through N / --no-product / --timeout`.
+- **Quieter output, shorter prints.** Cache and VTK chatter is gone; a printed
+  `BRepInspection` is a one-line summary.
 
-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.5.md`](docs/updates/2.2.5.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -446,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.3`.
+Current release: `simplecadapi==2.2.5`.
 
 ## What It Provides
 
@@ -961,6 +962,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 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)
 - 2.2.1 update notes: [`docs/updates/2.2.1.md`](docs/updates/2.2.1.md)

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

@@ -149,20 +149,21 @@ the full crank cycle sweeps clean in the same sim ·
 
 ---
 
-## Update Notes (2.2.3)
+## Update Notes (2.2.5)
 
 > 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.
+- **`sca cell` works behind container proxies.** The editor's discovery record is loopback and
+  proxy-proof, an unreachable record is reported instead of silently ignored, and file
+  fallbacks say so on stderr.
+- **Cell feedback carries the chain.** put/insert/run return console output and every cell
+  left unhealthy, stale dependents are run, and a failing cell names its upstream.
+- **Validate a stage headlessly.** `sca run --through N / --no-product / --timeout`.
+- **Quieter output, shorter prints.** Cache and VTK chatter is gone; a printed
+  `BRepInspection` is a one-line summary.
 
-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.5.md`](docs/updates/2.2.5.md).
 Earlier versions: the [changelog](CHANGELOG.md) and [`docs/updates/`](docs/updates/).
 
 ---
@@ -183,7 +184,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.5`.
 
 ## What It Provides
 
@@ -698,6 +699,8 @@ and the [STEP reconstruction workflow](docs/skill/references/workflows/step-reco
 
 ## Documentation
 
+- 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)
 - 2.2.1 update notes: [`docs/updates/2.2.1.md`](docs/updates/2.2.1.md)

{simplecadapi-2.2.3 → simplecadapi-2.2.5}/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.5
   package-name: simplecadapi
-  package-version: 2.2.3
+  package-version: 2.2.5
 ---
 
 # 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.3 → simplecadapi-2.2.5}/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.5}/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
@@ -35,9 +41,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.3 → simplecadapi-2.2.5}/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.5/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.5/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.5/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.5/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.3 → simplecadapi-2.2.5}/pyproject.toml

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

{simplecadapi-2.2.3 → simplecadapi-2.2.5}/src/simplecadapi/editor/cli.py

@@ -154,28 +154,79 @@ def _print_json(report: dict[str, Any]) -> None:
     print(json.dumps(report, indent=2, ensure_ascii=False))
 
 
+def _opener() -> Any:
+    """An opener that bypasses the proxy environment for the local editor.
+
+    The editor is on this machine (its url is 127.0.0.1); a container's
+    ``http_proxy`` does not know that and swallows the request, which once
+    read as "no editor is running" while one was.
+    """
+    import urllib.request
+
+    return urllib.request.build_opener(urllib.request.ProxyHandler({}))
+
+
 def _find_editor(start: Path) -> tuple[Path, str] | None:
-    """The running editor whose workspace holds *start*: ``(workspace, base url)``."""
+    """The running editor whose workspace holds *start*: ``(workspace, base url)``.
+
+    A record whose server does not answer is an error, not a stale record to
+    skip quietly: "an editor was running here" is exactly the belief that
+    must not be dropped in silence.  The one definite stale case is a record
+    whose process is gone (a crashed editor leaves its server.json behind).
+    """
     import json
-    import urllib.request
+    import os
+    import urllib.error
 
     here = start.expanduser().resolve()
+    unreachable: list[str] = []
+    opener = _opener()
     for directory in (here, *here.parents):
         record = directory / ".sca-editor" / "server.json"
         if not record.is_file():
             continue
         try:
-            url = json.loads(record.read_text(encoding="utf-8"))["url"]
-            with urllib.request.urlopen(f"{url}/api/health", timeout=1.5):
+            body = json.loads(record.read_text(encoding="utf-8"))
+            url = body["url"]
+        except (OSError, ValueError, KeyError) as error:
+            unreachable.append(f"{record}: unreadable ({error})")
+            continue
+        pid = body.get("pid")
+        if isinstance(pid, int):
+            try:
+                os.kill(pid, 0)
+            except ProcessLookupError:
+                unreachable.append(
+                    f"stale record {record} (pid {pid} is gone); delete it or restart the editor"
+                )
+                continue
+            except OSError:
+                pass  # a live process we cannot signal
+        try:
+            with opener.open(f"{url}/api/health", timeout=1.5):
                 pass
-        except (OSError, ValueError, KeyError):
-            continue  # a stale record: the editor is gone
+        except urllib.error.HTTPError:
+            pass  # an editor that answers at all is running
+        except OSError as error:
+            unreachable.append(f"found {record} but {url} is unreachable: {error}")
+            continue
         return directory, str(url)
+    if unreachable:
+        raise ValueError("; ".join(unreachable))
     return None
 
 
-def _call(url: str, path: str, body: dict | None = None) -> dict[str, Any]:
+def _call_timeout() -> float:
+    """How long one editor call may take; a heavy downstream rerun is on the
+    clock of the write that triggered it. ``SCA_EDITOR_CALL_TIMEOUT`` seconds."""
+    import os
+
+    return float(os.environ.get("SCA_EDITOR_CALL_TIMEOUT", "300"))
+
+
+def _call(url: str, path: str, body: dict | None = None, timeout: float | None = None) -> dict[str, Any]:
     import json
+    import socket
     import urllib.error
     import urllib.request
 
@@ -183,20 +234,29 @@ def _call(url: str, path: str, body: dict | None = None) -> dict[str, Any]:
     request = urllib.request.Request(
         url + path, data=data, headers={"Content-Type": "application/json"}, method="GET" if body is None else "POST"
     )
+    seconds = _call_timeout() if timeout is None else timeout
     try:
-        with urllib.request.urlopen(request, timeout=300) as response:
+        with _opener().open(request, timeout=seconds) as response:
             return json.loads(response.read())
     except urllib.error.HTTPError as error:
         try:
             return json.loads(error.read())
         except ValueError:
             return {"error": f"editor answered {error.code}"}
+    except (socket.timeout, TimeoutError) as error:
+        raise TimeoutError(f"the editor did not answer {path} within {seconds:g}s") from error
 
 
 def _session(args: argparse.Namespace, *, write: bool) -> tuple[str | None, Path | None, str]:
     """``(editor url or None, notebook path or None, relative notebook name)`` for a cell command."""
     start = args.workspace or (args.notebook.parent if args.notebook else Path.cwd())
-    found = _find_editor(start)
+    try:
+        found = _find_editor(start)
+    except ValueError as error:
+        if write:
+            raise
+        _warn(f"editor not reached: {error}")
+        found = None
     notebook = args.notebook.expanduser().resolve() if args.notebook else None
     if found is None:
         if write:
@@ -206,6 +266,7 @@ def _session(args: argparse.Namespace, *, write: bool) -> tuple[str | None, Path
             )
         if notebook is None:
             raise ValueError("no editor is running here; name the notebook with --notebook")
+        _warn(f"no editor is running on this workspace; reading the file: {notebook.name}")
         return None, notebook, notebook.name
     workspace, url = found
     open_path = _call(url, "/api/cells").get("notebook")
@@ -221,9 +282,17 @@ def _session(args: argparse.Namespace, *, write: bool) -> tuple[str | None, Path
             f"the editor has {open_path} open, not {relative}: edit {relative} directly "
             "(the editor does not hold it), or open it in the editor first"
         )
+    _warn(f"the editor has {open_path} open; reading {relative} from the file")
     return None, notebook, relative
 
 
+def _warn(message: str) -> None:
+    """Say a fallback out loud: silence once read as "the editor agreed"."""
+    import sys
+
+    print(f"warning: {message}", file=sys.stderr)
+
+
 def _cells_from_file(notebook: Path) -> list[dict[str, Any]]:
     from ..runtime._marimo import parse_notebook
 
@@ -239,7 +308,7 @@ def _cells_from_file(notebook: Path) -> list[dict[str, Any]]:
 def _slim(report: dict[str, Any], *, code: bool) -> dict[str, Any]:
     if "cells" not in report:
         return report
-    keep = ("index", "key", "name", "title", "status", "errors", "output", "ref", "readonly")
+    keep = ("index", "key", "name", "title", "status", "errors", "output", "console", "upstream", "ref", "readonly")
     return {
         **report,
         "cells": [
@@ -285,13 +354,25 @@ def _read_code(args: argparse.Namespace) -> str:
 def _write_op(args: argparse.Namespace, op: str, body: dict[str, Any]) -> tuple[dict[str, Any], int]:
     url, _notebook, _name = _session(args, write=True)
     assert url is not None
-    report = _call(url, f"/api/cells/{op}", body)
+    try:
+        report = _call(url, f"/api/cells/{op}", body)
+    except TimeoutError:
+        # The server took the write and reruns on its own; the clock that ran
+        # out is this call's, not the editor's.
+        return {
+            "error": "the edit was applied and the rerun is still going; check "
+            "`sca cell ls` (SCA_EDITOR_CALL_TIMEOUT raises the wait)"
+        }, 1
     if "error" in report:
         return _slim(report, code=False), 1
     touched = set(report.get("touched", []))
     report = _slim(report, code=False)
-    # What the change did: the touched cells with their state; the rest as a count.
-    report["cells"] = [c for c in report["cells"] if c.get("index") in touched] or report["cells"]
+    # What the change did: the touched cells with their state, plus any cell
+    # that is not healthy after the run — a rerun dependent failing is the
+    # feedback the edit was after, hiding it once read as "the edit was fine".
+    report["cells"] = [
+        c for c in report["cells"] if c.get("index") in touched or c.get("errors") or c.get("blocked")
+    ] or report["cells"]
     return report, 0