Varen CAD v0.22.3-beta

Varen CAD v0.22.3-beta Release Notes

Tag: v0.22.3-beta
Build date: 2026-09-24
Platform: Windows x64 portable
Status: Closed beta — concept design and rapid prototyping, not a manufacturing-release build
Artifact: VarenCAD-win64-0.22.3-beta.zip
SHA256: 7d039f1b30289bdad2f733eafc6fbff864b48de5a7461428e10eb5962b431dfc

---

Highlights

1. Part revision commits no longer dead-lock

The agent part library now commits the shape that is actually being finished. The shell audit no longer re-reads the old cached fingerprint after geometry changes.

• auditing uses the current transient shape;
• geometry, fingerprint, revision, and metadata are written atomically after the audit passes;
• a failed commit leaves the previous library revision intact;
• repeated finish_part calls either remain idempotent or create a clear new revision;
• assemblies use the active revision.

2. Minimal rigid transforms for gears and assembly instances

Gear creation and assembly placement now support real rigid transforms:

• make_gear accepts explicit origin, axis, and optional reference_direction;
• the default remains the origin with +Z for compatibility;
• assembly instances support translation and either axis-angle or a proper 3×3 rotation matrix;
• STEP export preserves instance transforms;
• interference checks evaluate transformed geometry.

This is intentionally a placement primitive, not a mate solver.

3. Clearer ask-user and parameter confirmation UI

Decision cards now expose their state before submission:

• ask-user cards show the number of answered questions and remaining required items;
• single-choice and multi-choice selections are visually distinct;
• numeric fields use number inputs;
• booleans use true/false selects;
• objects and arrays use JSON text areas;
• invalid numbers, booleans, and JSON are blocked with inline errors;
• original values can be restored;
• clarification cards can apply suggested values individually or all at once.

4. Safer model parameter editing

The model console no longer commits partial numeric input while typing:

• invalid values show an inline error;
• range and integer constraints are explicit;
• blur restores the last valid value;
• external updates from profile switching and project loading synchronize correctly.

5. Check-only update notifications

Varen CAD can now notify you when a newer GitHub release is available:

• the app checks once at startup;
• results are cached for six hours by default;
• the banner links to the GitHub release page;
• GitHub failures are silent and do not interrupt modeling;
• the check can be disabled with MECHCAD_UPDATE_CHECK=false.

The application does not automatically download, unzip, replace, or restart itself.

Verification

Quality gates run for this release:

• Frontend: 158/158 Vitest tests passed.
• Backend: 502/502 Python unittest tests passed.
• Kernel: 503/503 pytest tests passed.
• python -m compileall -q backend cad_worker passed.
• scripts/run_benchmark.py --dry-run passed.
• Frontend production build passed.
• Release archive SHA256 verified.
• Packaged archive checked for accidental .env inclusion.

Installation

1. Download VarenCAD-win64-0.22.3-beta.zip.
2. Verify VarenCAD-win64-0.22.3-beta.sha256 with:

   Get-FileHash .\VarenCAD-win64-0.22.3-beta.zip -Algorithm SHA256

3. Extract to a writable folder.
4. Run VarenCAD.exe.
5. Optional: configure models in Settings → Model, or copy .env.example to .env for source-code runs.

Known limitations

• Gear placement is manual; there is no meshing solver, kinematics simulation, or general mate solver.
• The update check is check-only; installation remains a manual download.
• Stepped holes are implemented in MechKernel but are not yet part of the high-level Varen feature schema.
• Semantic selection and BRep measurement remain single-part only.
• This beta does not provide complete 2D drawings, sheet metal, thread standards, general surface modeling, or a full assembly mate solver.
• Outputs require engineering review before manufacturing use.

License

The application and MechKernel integration are AGPL-3.0-or-later. Closed-source redistribution and OEM integration require a separate commercial license.

Varen CAD v0.22.2-beta

Varen CAD v0.22.2-beta Release Notes

Tag: v0.22.2-beta
Build date: 2026-09-23
Platform: Windows x64 portable
Status: Closed beta — concept design and rapid prototyping, not a manufacturing-release build
Artifact: VarenCAD-win64-0.22.2-beta.zip
SHA256: 1f404a658b2a68645ab8206d9d7ef2d4fbd1b983385d774a54132014122d0689

---

Highlights

1. Model console: .env persistence and provider profiles

The model console can now manage global defaults without asking you to edit a text file by hand:

• save the current vision or planner draft to the local .env file;
• save a switchable profile for each role and provider;
• switch a role by clicking a provider chip marked Saved;
• keep unrelated .env variables and comments intact during writes;
• update the running backend process environment after an atomic .env replacement.

Per-role saves are scoped. Saving the vision model does not clear an existing planner configuration in .env.

The precedence remains explicit:

project override > .env global default

Applying a saved profile clears that role's project override, so the next message resolves the model from .env. Tasks that are already running keep the model snapshot they were started with.

API keys are never returned to the browser. Existing project keys are copied server-side when a masked value is submitted; responses expose only the final four characters for recognition. An explicitly empty key clears that project override and falls back to .env.

2. Clearer effective-model preview

The console now reports what will actually be used after applying the draft:

• whether each role is configured;
• whether each field comes from the project, .env, or neither;
• the effective model, endpoint, protocol, and key tail;
• the missing fields that prevent a role from being usable.

This makes mixed configurations debuggable instead of leaving the user to guess whether a blank UI field means “not configured” or “use the global default”.

3. Real counterbore BRep geometry

The MechKernel hole operation no longer represents a counterbore as one simplified cylinder.

A counterbore is now two coaxial cylindrical cuts with a real shoulder:

• the small bore and large bore are separate measurable cylindrical faces;
• the shoulder is a real planar face;
• small diameter, large diameter, shoulder depth, and axis can be checked with the existing BRep topology query and measurement APIs;
• blind depth is derived from geometry, not just recorded from input parameters;
• degenerate parameters, non-finite values, and cuts that would remove the shoulder are rejected.

The kernel also adds a stepped hole operation with two or more strictly decreasing stages. This is available at the kernel operation layer; the high-level Varen feature palette does not yet expose stepped-hole authoring.

4. Structured stale-topology behavior

Old or invalidated semantic topology IDs now return a structured topology_not_found result instead of appearing to measure successfully against unrelated geometry.

Verification

Quality gates run for this release:

• Frontend: 143/143 Vitest tests passed.
• Backend: 489/489 Python unittest tests passed.
• Kernel: 488/488 pytest tests passed.
• python -m compileall -q backend cad_worker passed.
• scripts/run_benchmark.py --dry-run passed.
• Frontend production build passed.
• Release archive SHA256 verified.
• Packaged archive checked for accidental .env inclusion.
• Frozen --kernel mode smoke-tested over JSON-lines RPC.

Installation

1. Download VarenCAD-win64-0.22.2-beta.zip.
2. Verify VarenCAD-win64-0.22.2-beta.sha256 with:

   Get-FileHash .\VarenCAD-win64-0.22.2-beta.zip -Algorithm SHA256

3. Extract to a writable folder.
4. Run VarenCAD.exe.
5. Optional: configure models in Settings → Model, or copy .env.example to .env for source-code runs.

Known limitations

• Provider profiles are local to the machine and are not synchronized between installations.
• The model console does not hot-switch a task that is already running.
• Stepped holes are implemented in MechKernel but are not yet part of the high-level Varen feature schema.
• Semantic selection and BRep measurement remain single-part only.
• This beta does not provide complete 2D drawings, sheet metal, thread standards, general surface modeling, or a full assembly mate solver.
• Outputs require engineering review before manufacturing use.

License

The application and MechKernel integration are AGPL-3.0-or-later. Closed-source redistribution and OEM integration require a separate commercial license.

Varen CAD v0.22.1-beta

Varen CAD v0.22.1-beta Release Notes

Tag: v0.22.1-beta
Build date: 2026-09-22
Platform: Windows x64 portable
Status: Closed beta — concept design and rapid prototyping, not production release
Artifact: VarenCAD-win64-0.22.1-beta.zip
SHA256: dfaf3f88c9ecc7115a7092b4788715f4ab4590fda256d6805437367c2d0b2294

---

Highlights

1. BRep engineering measurements

The measurement tool now resolves references against the authoritative OpenCascade BRep geometry rather than approximating a clicked STL triangle:

• one cylinder face or circular edge → diameter (Ø);
• two cylinders/circular edges → axis-to-axis distance (A);
• two parallel planar faces → face-to-face distance (F);
• any other pair of face/edge/vertex topology → minimum distance (L).

Every result carries:

{
  "metric": "diameter | axis_to_axis | face_to_face | minimum_distance",
  "result": { "p1": [], "p2": [], "distance": 0, "dx": 0, "dy": 0, "dz": 0 },
  "algorithm": "occ_analytic_brep | occ_brep_extrema",
  "source": "brep",
  "units": "mm",
  "accuracy": 0.001,
  "geometry_revision": 0
}

The frontend draws the evidence points and connection returned by the kernel. This makes a measurement auditable instead of asking the user to trust a label.

2. Semantic topology IDs

Selection and measurement use stable semantic IDs:

face:<sha256>
edge:<sha256>
vertex:<sha256>

Reverse lookup is provided by query_topology and
POST /api/projects/{project_id}/geometry/topology/{topology_id}.
Stale IDs return a structured topology_not_found result rather than pretending that an old reference is still valid.

3. Robustness fixes

• Non-orthogonal or intersecting axes now return the true closest-point pair. Intersecting axes return the actual intersection as both evidence points.
• Parallel axes with origins shifted along the axis direction now measure the perpendicular offset only; axial origin shift is no longer added to the axis distance.
• Fixed the vertex topology reverse-lookup argument error.
• Kernel RPC rejects NaN/infinite point coordinates and non-positive/infinite tolerance values before they reach OCC.

Verification

Quality gates run for this release:

• Frontend: 139/139 Vitest tests passed.
• Backend: 480/480 Python unittest tests passed.
• Kernel: 481/481 pytest tests passed.
• python -m compileall -q backend tests passed.
• Frontend production build passed.
• Release archive SHA256 verified.
• Packaged archive checked for accidental .env inclusion.
• Frozen --kernel mode smoke-tested over JSON-lines RPC.

Installation

1. Download VarenCAD-win64-0.22.1-beta.zip.
2. Verify VarenCAD-win64-0.22.1-beta.sha256 with:

   Get-FileHash .\VarenCAD-win64-0.22.1-beta.zip -Algorithm SHA256

3. Extract to a writable folder.
4. Run VarenCAD.exe.
5. Optional: copy .env.example to .env and configure a model endpoint.

Known limitations

• Semantic selection and BRep measurement are currently single-part only.
• Assembly semantic selection requires per-part BRep geometry plus world-pose inverse transforms.
• This beta does not provide complete 2D drawings, sheet metal, thread standards, general surface modeling, or a full assembly mate solver.
• Outputs require engineering review before manufacturing use.

License

The application and MechKernel integration are AGPL-3.0-or-later. Closed-source redistribution and OEM integration require a separate commercial license.

Varen CAD v0.21.0-beta — 封闭 Beta（设计伙伴版）

会交付证据的机械设计 Agent — 封闭 Beta 开始

Varen CAD 从一句话到参数化装配：agent 调研、提问、出 BOM 计划等你批准，然后逐件建模，
每一步可回放、每个关键结果由程序检查——碰撞与契约不过关就不交付。

本版为封闭 Beta（Windows，未签名）：

• v0.16–v0.18 链路增强：同名返工原子换版、孔语义契约、硬碰撞阻断；壳体按包络反推 + 逐项程序审计（FAIL 0 阻断）
• v0.17/v0.19：5 挡手动变速器 26 件总成（325 对干涉全查、0 硬碰撞）+ 专业渲染
• v0.20：模型配置控制台；v0.21：右键零件透明度（SolidWorks 习惯）
• 发布基础设施：版本单一来源、AGPL + 商业双许可、诊断导出、公开 benchmark 骨架

已知限制（详见 KNOWN_ISSUES.md）：无 2D 工程图；装配位姿来自 BOM 数值而非约束求解；
production_ready 恒为 false——输出是概念原型，投产前必须人工复核。

安装（Windows 10/11 x64，≈180 MB）

1. 下载 VarenCAD-win64-0.21.0-beta.zip，校验：Get-FileHash .\VarenCAD-win64-0.21.0-beta.zip -Algorithm SHA256
   应等于：a04ca10883db4f43a142276c61c9aa3164614d79cb81e870f152e1f1be86a441
2. 解压到任意目录（路径不含中文更稳），双击 VarenCAD.exe。
3. SmartScreen 提示"未知发布者"属预期（未签名）：点"仍要运行"，来源核查见本页校验值。
4. 浏览器自动打开 http://127.0.0.1:8001/；首次运行预热约 30 秒。
5. 设置中心 → 模型：配一个 OpenAI 兼容端点（设计伙伴可申请限额试用端点）。
6. 试一句：做一块 120×120×12 法兰，中心 Ø30 通孔，6 个 Ø8 螺栓孔在 Ø90 圆上。

卸载：删除解压目录即完成（数据全在本地 work/，可一并删除）；托盘右键 → 退出。

反馈

• Bug → 模板；任务失败 → 专用模板（会进公开 benchmark）
• 产品内：设置中心 → 支持 → 一键导出诊断包（不含 API key）
• 加入设计伙伴：申请入口

完整运行记录

prompt、模型、版本、耗时、步数、结果与失败见 benchmark/results/。

---

License: AGPL-3.0-or-later（社区）+ 商业双许可（闭源分发/OEM）。

v0.10.0-alpha — 对话式 Agent 会话（真 harness）

Varen CAD v0.10.0-alpha — 对话式 Agent 会话

把"表单 + 进度条"升级为 Claude Code 式对话 harness:每个项目一条持久 agent 会话,聊天即指令,AI 的文字、工具调用、几何快照全部留在会话流里。

亮点

• 💬 持久会话:每项目一条会话(work/agent_sessions/),重开项目回看全部历史;POST /agent/message 空闲=开新任务、运行中=插话(下一轮生效)
• ⌨️ token 级流式:OpenAI / Anthropic 双协议 SSE,模型文字经 WS agent_text_delta 打字机上屏
• 🧰 可读过程:每个 kernel op 是一张内嵌工具卡(op / 参数 / 结果 / 自修复标记)
• 🖼 几何可视化快照:几何变化时自动 kernel render(iso 证据图),会话流内嵌缩略图,点击看原图
• 🖼 vision 进 agent:会话首条消息自动携带左侧上传的草图
• 🔧 审批契约修复:approval_required 现携带 approval_id(v0.9 中审批卡实际无法弹出)
• 🌏 流式中文乱码修复(SSE 强制 UTF-8)、STL/STEP 导出路径修复

质量

• 后端 330 测试 / 前端 72 测试全绿
• 端到端实测:本地脚本化 LLM + 真实 MechKernel 内核,对话→流式→工具卡→几何→STL/STEP→快照→会话恢复全链路通过

升级注意

• 拉取后重启后端(托盘"重启服务"即可);旧会话文件不兼容无需迁移(agent 会话按项目存新目录 work/agent_sessions/)
• FeaturePlanV3 旧链路保持冻结,API 不变

Full changelog: 见 CHANGELOG.md

MechCAD IDE v0.4.0

• Added ProcessStep and ProcessRecorder; every run now records upload -> vision -> planning -> validation -> chat_edit/cad -> export.
• Chat edits now produce an auditable FeatureEditSet with add, update, delete, and change_type operations instead of replacing the whole FeaturePlanV3.
• Local deterministic editing covers center-hole diameter changes, hole moves, groove deletion, and M6 hole pattern creation.
• Strict mode blocks unconfirmed inferred dimensions; deleting a parent with children asks for confirmation instead of silently breaking dependencies.
• CAD Worker reports per-feature running/completed/skipped/failed steps through JSONL and WebSocket, with real error details in the execution report.
• Property-panel edits also generate an update process step with before/after snapshots.
• Process timelines persist with snapshots and are restored by undo/redo.
• Frontend adds a Process tab with grouped statuses, feature IDs, warnings, and failure reasons.
• Fixed duplicate Worker progress events and unawaited coroutine warnings in the event bridge.

MechCAD IDE v0.3.0

• SolidWorks-style three-panel layout with full-screen 3D viewport and drawer panels.
• Startup page, recent projects, settings center, and Chinese/English switching.
• Single-port production mode plus Windows tray launcher and desktop shortcut.
• API/model configuration moved into Settings.

MechCAD IDE v0.2.0

• React + TypeScript + Vite + Three.js frontend.
• FastAPI REST + WebSocket backend.
• Controlled CAD Worker subprocess with Build123d.
• FeaturePlanV3 validation, design review, clarification questions, and session persistence.

MechCAD IDE v0.1.0

• Hand-drawn sketch to 3D model pipeline.
• OpenCV preprocessing, vision analysis, AI planning, sandboxed CAD execution.
• STEP/STL/OBJ export and Gradio UI.