98 Commits

Author SHA1 Message Date
NiJingzhe 3ad47b60fc README: the idea, the evidence, the skill, the plugins
Rewritten to 148 lines each (was 769 and 650): three pillars (efficient, low-overhead, agent-native), two comparison charts
(against CadQuery on 200 parts; tokens per task against a mature industrial CAD through its MCP; English and Chinese,
drawn by tools/make_readme_charts.py), the two six-axis arms in the new editor, the skill (seven routes and how it is
organised) and the plugin system. The update notes live in CHANGELOG.md and docs/updates.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-09 03:02:05 +08:00
NiJingzhe 2ce6b3f475 release: 2.2.7
Version in pyproject.toml, the project entry of uv.lock and SKILL.md; the CHANGELOG heading; docs/updates/2.2.7 (EN and
zh-CN); the update notes of both READMEs replaced with this version's.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-30 18:29:02 +08:00
NiJingzhe b626269ecf feat(verify): simplecadapi.verify and the verify extra for verifier scripts; drop the fem extra
shape.wrapped is the SDK's own binding, so OCP functions reject it and verifier scripts that did
BRepGProp.VolumeProperties_s(solid.wrapped, ...) stopped working with the C++ engine. simplecadapi.verify.to_ocp / from_ocp
bridge through OpenCASCADE's binary format; the verify extra installs OCP 7.9 without VTK. The SDK itself never imports OCP.
The skill gets references/discipline/verifier-scripts.md, whose code the tests execute.

The fem extra (gmsh, ccx2paraview[VTK]) is removed with the README steps that used it; vtk is out of the lock file.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-28 01:13:18 +08:00
NiJingzhe 3788f03de1 feat(inspect): inspect.brep is part of the default install
matplotlib moves to the core dependencies; the inspect extra stays as an empty alias so older
install commands work. The wheel smoke test renders a STEP through inspect.brep.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-25 16:28:55 +08:00
NiJingzhe c9c4cab4ce release: 2.2.7b1
Beta: the first release with prebuilt wheels (Linux x86_64 and aarch64, macOS arm64, Windows x86_64,
Python 3.10-3.13).  Version in pyproject.toml, the uv.lock project entry and SKILL.md; CHANGELOG, update notes
(English and 中文), README update notes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-24 02:55:56 +08:00
NiJingzhe 112c404d56 release: 2.2.6.post2
Move scale/transform/boolean_rsolidlist/offset/draft/extrude_taper/extrude_until/
sweep_multisection into the module of their family (old module paths remain as
deprecated aliases); the API reference is generated for every operator.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-21 01:29:29 +08:00
NiJingzhe 302e62195d docs: 2.2.6.post1 notes cover the cache and use speed-up
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-21 00:34:40 +08:00
NiJingzhe 63704c1ca9 release: 2.2.6.post1
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-20 21:52:07 +08:00
NiJingzhe 47fb649f64 release: 2.2.6
Co-Authored-By: GLM-5.3-Flash <noreply@zhipuai.com>
2026-10-19 01:30:37 +08:00
NiJingzhe b230356dee release: 2.2.5
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-15 20:13:08 +08:00
NiJingzhe 1a46ccb238 release: 2.2.4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-15 02:32:42 +08:00
NiJingzhe 794d9a5331 release: 2.2.3 (not 2.3.0)
The version of this release is 2.2.3: rename the version, update notes and README references.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-14 15:35:04 +08:00
NiJingzhe f90ae2d0fe release: 2.3.0
Version bump, changelog heading, update notes (EN/中文), SKILL.md metadata, README.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-14 15:32:41 +08:00
NiJingzhe f2ef7fa2ab docs(readme): the update notes cover only the latest version
The section accumulated 2.2.1 and 2.1.3b1 items; it now describes 2.2.2 and points to the
changelog and docs/updates for earlier versions.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-14 00:59:47 +08:00
NiJingzhe 4a03c47147 release: 2.2.2
Version bump, changelog heading, update notes (EN/中文), SKILL.md metadata, README.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-14 00:58:26 +08:00
NiJingzhe afe4b526bc release: 2.2.1
Version bump, changelog (2.2.1 section, including the modeling features and exact
volume integration of the build123d work), update notes in English and Chinese,
README pre-release notices removed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-13 17:48:10 +08:00
NiJingzhe 8816d511b0 docs(readme): lead with the agent landing line; the new editor replaces Re-Studio
- both READMEs open with the line to paste to a coding agent
- pillar 3 is now the code-first editor (screenshot added); Re-Studio and the
  standalone sca-web-editor references are gone
- update notes for 2.2, install and examples sections brought up to date
- remove the Re-Studio skill workflow and its demo media (10 MB)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-13 13:22:47 +08:00
NiJingzhe 86522a19bc docs(readme): the agent-landing line and the editor install
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-12 23:27:54 +08:00
NiJingzhe 64f2cc9c61 feat(editor): sca edit — the web editor, now part of the SDK
The editor moves in from sca-web-editor as simplecadapi.editor (UI sources
in editor-web/, built into the package; 'editor' extra). It no longer
records anything itself: the kernel runs the notebook with the SDK cell
executor, the server asks it for the product (runtime.live.publish_live)
when marimo reports a completed run, and parameters are saved values the
executor applies, so marimo's dataflow reruns what reads them. Controls
come from '# ui:' comments; a workspace is any directory of notebooks.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-11 05:55:50 +08:00
NiJingzhe b1b9ec06e4 docs(readme): teach the notebook runtime as the modeling workflow
Quick Start is now a bracket notebook (params cells, one FTC block per
cell, final scad.Part, app.run() footer) run with marimo edit, sca run and
sca export. Notebook Runtime follows it with run_notebook export scripts,
scad.use composition, part families (scad.notebook_id / --id), library
builders, and a migration note for @scad.part scripts and the removed part
cache. GraphSession is scoped to inspection and replay outside notebooks.

Also: list notebooks first under What It Provides; move the turntable note
out of the table; point Re-mode at the standalone sca-web-editor; replace
the dead design-docs/scadpkg-spec.md link with scadpkg-format.md.

README.zh-CN.md mirrors the structure, and its STEP/BREP section now
documents simplecadapi.inspect.brep instead of the removed agent tool
registry; it gains the Examples section.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-02 20:47:07 +08:00
NiJingzhe 5177f4f186 docs(skill): teach the notebook runtime; drop the cache workflow
- new guide docs/guides/notebook-runtime.md: the header table, one FTC
  block per cell, the product-id rule, part families with notebook_id()
  and use(id=...), sca run and run_notebook
- SKILL.md, the workflows, domains and discipline references now build
  models as notebooks; the feature-tree convention maps blocks to cells
- regenerated API pages: run_notebook, use, notebook_id, NotebookRun,
  NotebookConfig, CellReport; removed the Cache*, ContentAddressedStore,
  resolve_cache_policy and incremental-solve pages, and the
  cache-build-workflow guide
- README / README.zh-CN: notebook quick start and example commands

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-02 17:16:25 +08:00
NiJingzhe c72bc5e610 refactor: remove re-mode viewer; studio lives in sca-web-editor
The standalone viewer/ React app (scene viewer + re-mode) and its case
server tests are deleted; the studio product now lives in the separate
sca-web-editor workspace runtime. Docs/updates refreshed accordingly;
pyproject picks up marimo/plotly used by the notebook tooling.
2026-09-26 23:06:12 +08:00
NiJingzhe 1330e7cf62 docs: point repo URLs at PhySpace/SimpleCADAPI
The repository moved to the PhySpace org: pyproject project.urls
(carry into wheel metadata on the next release) and the README star
history charts now reference the new location.
2026-09-22 23:02:23 +08:00
NiJingzhe 1f7d0cb9fa chore(release): 2.1.3
CHANGELOG added; version bumped to 2.1.3 across pyproject, skill
frontmatter, and README current-release lines; generated skill docs
refreshed via tools/auto_docs_gen.py.
2026-09-18 11:12:54 +08:00
NiJingzhe f53f1702c0 docs(readme): add Star History chart 2026-09-18 11:02:07 +08:00
NiJingzhe 264a904f8b feat(skill): 'sca skill targets|install' + skill source shipped in wheel
The wheel force-includes the uncompiled docs/skill source tree and
skillproj.toml as package resources; compilation happens at install
time on the user's machine, so no repository checkout is needed.

The compiler moves to simplecadapi.skill.compiler; tools/skillbuild.py
stays as the maintainer-side wrapper over the same code.

'sca skill install' compiles into <skills-dir>/simplecadapi (location
resolved through the existing addon config/env chain, default
~/.agents/skills; no sca init required) and refuses to overwrite
without --force, which only permits replacing a directory whose
SKILL.md declares the same skill name.
2026-09-18 10:54:13 +08:00
NiJingzhe b939f44043 feat(cli): single 'sca' entry point + 'sca init' shell integration
- simplecad-cache/simplecad-export entry points are gone (hard cut):
  the same commands live under the unified dispatcher
  (simplecadapi.cli) as 'sca cache ...' and 'sca export ...', each
  group registered at parser level so per-group --help works
- sca init now wires the shell by default (--no-shell skips): a
  ~/.sca/bin/sca shim (Windows sca.cmd) execs the installing venv's
  console script — the venv bin itself never goes on PATH — and the
  shim dir lands on PATH via a marked, removable block in ~/.zshenv
  (read by non-interactive shells, so agents see the command),
  ~/.bashrc, fish conf.d, or the Windows user PATH registry value
  with a change broadcast; rc files are created only for the login
  shell or when they already exist; re-running init refreshes the
  shim (target discovery is symlink-safe, no resolve() out of venv)
- addon/cache/export cli modules expose configure(subparsers) +
  _execute(args); module run() keeps the CLI-shaped argv
- docs: sca namespace across evergreen docs, shell-integration
  section, 'never writes shell profiles' contract line retired
- tests: +17 (dispatcher groups, shell integration, entry-point
  absence); cache/export suites moved to group-token argv
2026-09-13 04:19:17 +08:00
NiJingzhe be93122527 chore(release): bump version to 2.1.3b1 2026-09-10 14:50:05 +08:00
NiJingzhe aac0fbb29d feat(cache): script-anchored part cache, keyword-form corpus, 2.1.2
- @scad.part/@scad.assemble anchor defaults to the builder script's own
  directory: cache + interface state land beside the source, standalone
  scripts run anywhere, and the pyproject.toml walk-up requirement is
  gone (explicit project_root still relocates the anchor)
- file_input() paths resolve relative to the anchor; in-repo examples
  rewritten to script-relative declarations
- HistCAD translator emits keyword-form sketch-family calls (corpus
  self-documentation), pinned by tests; booleans stay positional by
  *solids signature
- both translators emit project_root=Path(__file__).parent explicitly;
  examples/histcad_demo regenerated (STEP volume reconciliation held)
- FTC convention documents @scad.part parameters and the cache contract
- version stamps 2.1.2 + bilingual update notes
2026-09-10 00:11:28 +08:00
NiJingzhe 197bf40c6b chore(release): bump version to 2.1.1
Tooling patch: SDK API unchanged. Adds the CadQuery→FTC translator toolset
with snapshot constraint recovery (merged in #49) and its bilingual update
notes; version stamps updated in pyproject+lock, SKILL frontmatter, and
both READMEs.
2026-09-09 22:12:13 +08:00
NiJingzhe ce29d41d8f docs(readme): align examples and doc links with the 2.1.0 layout
- Examples section rewritten for the self-contained per-example layout
  (named folders, per-example out/, category index in examples/README.md)
- Documentation links repointed to docs/skill/references/** — the old
  docs/api, docs/core, docs/guides tops never existed in the tree
- demo replay links and FEM command blocks follow the renamed
  ap242_gmsh_volume_mesh / integrated_bldc_joint_actuator folders
2026-09-07 11:10:00 +08:00
NiJingzhe a45cbf280e chore(release): 2.1.0
- version 2.0.4b3 -> 2.1.0 (pyproject, uv.lock, skill frontmatter, READMEs)
- docs/updates/2.1.0.md + zh-CN: release notes spanning the 2.0.4b2 baseline
  (absorbs the unreleased 2.0.4b3 draft: product boundaries, incremental
  assembly, crash-safe cache) plus FTC authoring, DXF engine, external
  history import, reverse-engineering studio, unified rendering, Apache-2.0
  relicensing, harness-targeted skill builds, self-contained examples, and
  the geometry fingerprint round-trip fix
2026-09-07 09:45:57 +08:00
NiJingzhe c0bfabb3a3 chore: relicense to Apache-2.0
Replaces the AGPL-3.0 license text with the canonical Apache License 2.0
and updates every reference: pyproject trove classifier, both README
license sections, and the skill frontmatter. The article drafts under
docs/ are untracked and were updated separately.
2026-09-06 18:42:33 +08:00
NiJingzhe b25b55e802 showcase: re-studio reverse-engineering MVP video
The reverse-engineering section ships its demo: the re-studio MVP session —
click faces on the STEP target, stack operation-intent chips and notes per
pick, submit, and the agent takes over from your context (classifying all 37
faces of a link rod before rebuilding). UI selections plus the operator's
hunches become the agent's narrowed search space.

Source recording (78 MB, 1668x1080@60, 78 s) stays local via gitignore; the
repo tracks a 6.1 MB H.264 MP4 (full session) and a 770 KB GIF preview of
the annotate-and-submit window (30-50 s) inline in both READMEs.
2026-09-06 14:06:43 +08:00
NiJingzhe 2e0577df48 showcase: four-bar MuJoCo virtual-collision before/after pair
The simulation-plugin section ships its real evidence now: two screen
recordings of the MuJoCo replay viewer — the first assembly pass where the
links crash through each other mid-cycle (wrong assembly), and the corrected
assembly sweeping the full crank cycle clean in the same sim.

Source recordings (74 MB, 2410x1844@60) stay local; the repo tracks lean
derivatives: 1450px/30fps H.264 MP4s (0.6 + 0.9 MB) as click-through full
videos and 700px/10fps palette GIFs (1.1 + 2.3 MB) inline in both READMEs.
Drops the bracket-STL placeholder image that stood in for this cell.
2026-09-06 14:00:56 +08:00
NiJingzhe fb29140206 merge: integrate dev (PR #36 viewer re-composer) into 2.1.0-open 2026-09-06 03:58:44 +08:00
NiJingzhe 47b0636da2 showcase: BLDC assembly section upgraded to new studio renders + exploding turntable GIF
- img/capability: refreshed bldc_assembly/front/exploded studio stills
  and added bldc_exploded.gif (72-frame inclined-orbit exploding
  turntable; four modules separate axially, concentric parts peel into
  radius bands)
- README EN/zh assembly cards: exploded still replaced by the turntable
  GIF with captions describing the four-module axial explode
2026-09-06 01:54:58 +08:00
auua 6c74001ab3 feat(cli): Encapsulate the export function into a CLI tool. 2026-09-05 23:51:42 +08:00
NiJingzhe cbb0e33154 showcase: prompt + BRep turntable GIF table for single-part cases
- README.md / README.zh-CN.md section 1: each case now shows the
  first-turn requirement (verbatim excerpt) next to a turntable GIF of
  the delivered model; flange row notes the 6->8-hole re-parameterization
  so the 8-hole GIF cannot read as inconsistent with the prompt
- turntables rendered by the in-repo Scene Viewer BRep renderer through
  the new viewer/src/embed-bundle.ts (reusable mountScene + camera utils)
  and viewer/gif-harness.html (deterministic azimuth stepping, 48 frames
  per turn), captured headless and assembled as looping GIFs
- img/capability: three turntable GIFs (0.7-1.6 MB each)
- vite build gains the gif-harness input
2026-09-05 21:54:12 +08:00
NiJingzhe f53dec2f70 showcase: viewer BRep renders + before/after re-parameterization slots
- flange/bracket demo images re-rendered through the in-repo Scene Viewer
  (BRep face shading + edges, camera normalized to the scene bounding
  sphere) via headless Chrome capture; raw-solid VTK renders replaced
- flange demo: caption bug fixed ('六特征块' read as six holes vs the
  8-hole final model); renders tab now leads with the 6-hole @PCD 78
  initial state next to the final 8-hole @PCD 84.5, making the turn-2
  re-parameterization visible; glCap states the final state explicitly
- bracket demo: three viewer views (iso/top/detail)
- README cards: flange/bracket images swapped to viewer renders; captions
  clarified to '6→8-bolt'
2026-09-05 21:26:53 +08:00
NiJingzhe f65109c6e7 docs(showcase): four-capability README front section with session replay demos
- README.md / README.zh-CN.md: capability pillars (single part / assembly /
  reverse engineering / simulation) with case images and replay demo links
- examples/demo_kit: config-driven single-file replay demo builder
  (generalized from u_link demo; app.js consumes per-case config payload)
- examples/flange_plate: full single-part-modeling workflow case (agent
  session transcript + verifier scripts + 8-hole re-parameterization with
  guard rejection chain) + replay demo
- examples/12_ap242_gmsh_volume_mesh: model.py rebuilt through the workflow
  (FTC feature blocks, named vars; volume rel 0.00e+00 vs legacy, FEM
  interface tags preserved) + REQUIREMENTS/BUILD_PLAN/verify + replay demo
- examples/u_link_motor_mount/demo: committed single-file replay demo,
  rebuilt via demo_kit
- examples/20_integrated_bldc_joint_actuator/render_showcase.py: assembled
  + staged cylindrical exploded views from the captured package
- img/capability: showcase renders (BLDC assembly/exploded, bracket FEM
  von Mises, case ISO views)
2026-09-05 21:02:43 +08:00
Ni Jingzhe c454a3af10 feat(skill): per-harness skillbuild toolchain replaces skill-pack (#18)
* feat(skill): replace skill-pack with per-harness conditional compiler

skillbuild compiles the skill tree into per-target harness builds:
- <!-- skill:if omp,!claude --> blocks include text only for matching
  targets; name-list conditions only, no else/nesting, fail-loud on
  unknown targets and unpaired/nested directives
- fence-aware: directive-looking lines inside code fences are literal
- layout is the filesystem; tree root configured in skillproj.toml
- post-build assertion: zero directive residue, SKILL.md frontmatter
  name check

Migration to the new model:
- docs/skill/ becomes the self-contained source root (SKILL.md,
  references/, generated api/stdlib/core/guides now under
  references/docs/; SDK_OVERVIEW/LICENSE/inspect are ordinary tree
  files)
- auto_docs_gen output redirected into the tree (docs/api ->
  docs/skill/references/docs/api, likewise stdlib)
- skills/simplecadapi/ is now the compiled omp target output;
  dist/generic/simplecadapi the generic target
- dropped skill-pack entry point (plus dangling evolve/make-export
  entries and their orphaned test), release workflow builds via
  skillbuild + tar; README updated

First real conditional block: harness reading paths in SKILL.md
(skill:// mount on omp vs disk-relative on generic).

Verified: 59 tests pass (skillbuild 31, auto_docs_gen 19, persistence
regression 9); both targets build; outputs residue-clean; full suite
collects (1376 tests).

* refactor(tools): auto_docs_gen moves out of the installed package

tools/ scripts are repo-checkout dev scripts, not packaged CLIs:
- auto_docs_gen.py now lives in tools/ beside the other generators;
  auto_tools/ package removed entirely
- path resolution simplifies: repo root = parent of tools/, fail-loud
  if pyproject.toml missing; site-packages/cwd fallback branches were
  dead code once the script stopped shipping in the wheel
- auto-docs-gen console script dropped from [project.scripts];
  release.yml and README invoke python tools/auto_docs_gen.py
- MANIFEST.in stale src/auto_tools include removed; CadQuery-free
  runtime scan no longer needs the auto_tools filter
- run_examples.py retired (user removal): README example-runner text
  updated to direct examples/ scripts; dangling runner-contract test
  (runpy.run_path into the deleted script) removed

Verified: 53 tests pass (auto_docs_gen + skill_build + ocp runtime
scan) and test_example_model_contract passes; regeneration from
tools/ is byte-identical (zero docs drift).

* refactor(skill): strip harness and build-tool content from the skill tree

The skill is plain harness-neutral content again:
- SKILL.md 'Reading skill files' section removed (the omp skill://
  mount block and its !omp complement were the only conditional
  blocks; the tree compiles identically for every target now)
- references/README.md: build-tool meta removed ('per-harness
  conditional compilation', skillbuild packaging/validation claims —
  link validation was never implemented, so the claim was false)
- live test now asserts the tree stays harness-neutral (zero blocks)
- skillproj.toml targets aligned with the user's output table
  (omp -> skills/simplecadapi-omp, opencode -> skills/simplecadapi-opencode;
  leftover 'generic' entry had no output and failed the build)
- compiled outputs are regenerable artifacts: skills/simplecadapi/
  untracked from git, skills/simplecadapi-*/ gitignored, release.yml
  and README build via skillbuild and tar the omp output directly
  (bsdtar has no --transform; inner dir keeps its suffixed name)

Verified: 49 tests pass; both targets build 372 files with zero
conditional blocks; no omp/conditional/directive residue in the tree
or outputs.

* chore(docs): drop stale architecture review and design notes
2026-08-22 20:20:49 +08:00
NiJingzhe ba1e06a489 feat: expand product exporters and FEM workflow 2026-08-18 01:36:44 +08:00
NiJingzhe 9d6703a786 feat: enforce canonical product capture workflow 2026-08-15 16:17:11 +08:00
NiJingzhe 89564ee1f5 Add durable part and assembly caching 2026-08-11 17:06:00 +08:00
PengDu c881eac641 Fix/cadir (#25)
* fix paper link

* fix paper link
2026-08-06 15:41:11 +08:00
NiJingzhe 675afb9b85 feat: consolidate BREP inspection workflow 2026-08-04 23:45:23 +08:00
Codex c5217dc0d5 docs: add 2.0.4b2 reconstruction notes 2026-08-03 14:30:05 +08:00
NiJingzhe 9758542fbe Prepare 2.0.4b1 release 2026-08-02 15:56:49 +08:00
NiJingzhe 9e8450f192 feat: add py-slvs sketch solver backend 2026-07-30 01:00:01 +08:00