forgecad 0.6.3 → 0.7.0

package/dist-skill/SKILL-dev.md

@@ -5,43 +5,24 @@ description: ForgeCAD development skill — model authoring plus compiler intern
 
 # ForgeCAD
 
-Author or modify ForgeCAD models, sketches, assemblies, notebooks, and CLI workflows. Prefer documented primitives, import rules, placement strategies, and CLI commands over inventing new APIs.
+Author or modify ForgeCAD models, sketches, assemblies, and CLI workflows. Prefer documented primitives, import rules, placement strategies, and CLI commands over inventing new APIs.
 
 ## Workflow
 
-1. Identify the artifact: `.forge.js`, `.forge-notebook.json`, SVG asset, or CLI/export task.
+1. Identify the artifact: `.forge.js`, SVG asset, or CLI/export task.
 2. Load only the docs the task needs (see Source Map below). Start from the top group, add others as needed.
 3. Default to a concrete first pass — easy iteration beats speculative design review.
 4. If an existing model is broken, replace the weak structure rather than preserving bad architecture.
-5. Validate with `forgecad run <file>` (add `--debug-imports` for import chain issues). This works for notebook preview cells too.
+5. Validate with `forgecad run <file>` (add `--debug-imports` for import chain issues).
 6. For `jointsView()` animations, keep wrapped revolute tracks continuous across branch cuts; do not assume the viewport will auto-fix `-180/180` jumps.
 
 ### Import and Composition
 
 - `require("./file.forge.js", { Param: value })` for any model file, with optional param overrides.
 - `importSvgSketch()` for SVG files (file format loader, not a module import).
-- `.withReferences()` + `.placeReference()` for reusable placement.
+- `.placeReference('bottom', [0,0,0])` to align any built-in anchor to a world coordinate; also works with custom `.withReferences()`.
 - Plain `.js` modules for shared helpers/constants (not model imports).
 
-### Notebooks
-
-Use `.forge-notebook.json` for stateful iteration and debugging. Cells share state, `show()` pins visible geometry, and the preview cell can be validated or rendered directly from the CLI.
-
-Prefer notebooks when:
-
-- the task is exploratory or the geometry strategy is still unclear
-- you are debugging booleans, placements, or assembly kinematics
-- you want to inspect intermediate shapes or sketches without rewriting the whole file
-
-Useful notebook loop:
-
-- keep stable setup in early cells and the current experiment in the preview cell
-- use `show(...)` for intermediate geometry you want pinned in the viewport
-- use `forgecad notebook view <file> preview` to inspect the notebook from the terminal
-- use `forgecad run <file>.forge-notebook.json` for preview-cell validation and spatial analysis
-- use `forgecad render <file>.forge-notebook.json` or `forgecad capture gif <file>.forge-notebook.json --list` to inspect the preview cell through the CLI
-- export to `.forge.js` when the exploratory phase is over and the structure is ready to stabilize
-
 ## Source Map
 
 Load groups top-to-bottom, stopping when you have what the task needs.
@@ -50,19 +31,9 @@ Load groups top-to-bottom, stopping when you have what the task needs.
 
 Execution model, colors, coordinate system, primitives, booleans, patterns, imports, parameters, topology, edge queries.
 
-- `{{SKILL_DIR}}/docs/API/core/reserved-terms.md`
 - `{{SKILL_DIR}}/docs/API/core/concepts.md`
-- `{{SKILL_DIR}}/docs/API/core/parameters.md`
-- `{{SKILL_DIR}}/docs/API/core/topology.md`
-- `{{SKILL_DIR}}/docs/API/core/edge-queries.md`
 - `{{SKILL_DIR}}/docs/generated/core.md`
 
-### 1b. SDF Modeling (when using smooth booleans, TPMS, deformations, or fromFunction)
-
-Primitives, smooth booleans, TPMS lattices, twist/bend/displace, morph, custom functions, gotchas.
-
-- `{{SKILL_DIR}}/docs/API/core/sdf.md`
-
 ### 2. Geometry and Positioning (when placement/orientation matters)
 
 Axis conventions, winding rules, and placement strategy.
@@ -71,21 +42,10 @@ Axis conventions, winding rules, and placement strategy.
 - `{{SKILL_DIR}}/docs/guides/geometry-conventions.md`
 - `{{SKILL_DIR}}/docs/guides/positioning.md`
 
-### 3. Sketch APIs (when the task is sketch-heavy)
+### 3. Sketch APIs
 
 2D construction, transforms, booleans, paths, on-face sketching, extrusion, anchors, text, regions.
 
-- `{{SKILL_DIR}}/docs/API/sketch/core.md`
-- `{{SKILL_DIR}}/docs/API/sketch/primitives.md`
-- `{{SKILL_DIR}}/docs/API/sketch/path.md`
-- `{{SKILL_DIR}}/docs/API/sketch/transforms.md`
-- `{{SKILL_DIR}}/docs/API/sketch/booleans.md`
-- `{{SKILL_DIR}}/docs/API/sketch/operations.md`
-- `{{SKILL_DIR}}/docs/API/sketch/on-face.md`
-- `{{SKILL_DIR}}/docs/API/sketch/extrude.md`
-- `{{SKILL_DIR}}/docs/API/sketch/anchor.md`
-- `{{SKILL_DIR}}/docs/API/sketch/text.md`
-- `{{SKILL_DIR}}/docs/API/sketch/regions.md`
 - `{{SKILL_DIR}}/docs/generated/sketch.md`
 
 ### 4. Curves and Surfacing (for lofts, sweeps, splines)
@@ -98,38 +58,31 @@ Smooth curves, Hermite splines, lofted and swept solids.
 
 Assembly graph, joint types, couplings, validation, robot export.
 
-- `{{SKILL_DIR}}/docs/API/assembly/assembly.md`
 - `{{SKILL_DIR}}/docs/generated/assembly.md`
 
 ### 6. Sheet Metal (for bent parts, K-factor, flat patterns)
 
 Bend operations, flat pattern unfolding, K-factor configuration.
 
-- `{{SKILL_DIR}}/docs/API/sheet-metal/sheet-metal.md`
 - `{{SKILL_DIR}}/docs/generated/sheet-metal.md`
 
 ### 7. Output and Export (for STL/3MF/STEP, BOM, dimensions)
 
 Mesh export, exact geometry export, bill of materials, dimension annotations.
 
-- `{{SKILL_DIR}}/docs/API/output/export.md`
-- `{{SKILL_DIR}}/docs/API/output/brep-export.md`
-- `{{SKILL_DIR}}/docs/API/output/bom.md`
-- `{{SKILL_DIR}}/docs/API/output/dimensions.md`
 - `{{SKILL_DIR}}/docs/generated/output.md`
 
 ### 8. Toolbox (fasteners and standard parts)
 
 Parametric bolts, nuts, washers, standard hardware, gears, pipes, and structural profiles.
 
-- `{{SKILL_DIR}}/docs/API/toolbox/fasteners.md`
 - `{{SKILL_DIR}}/docs/generated/lib.md`
+- `{{SKILL_DIR}}/docs/generated/wood.md`
 
 ### 9. Runtime Viewport APIs (for cut planes, jointsView, and animation playback)
 
 Viewer-only APIs such as cutPlane, explodeView, jointsView, and animation behavior.
 
-- `{{SKILL_DIR}}/docs/API/runtime/viewport.md`
 - `{{SKILL_DIR}}/docs/generated/viewport.md`
 
 ### 10. Recipes and Debugging (for patterns and troubleshooting)
@@ -140,15 +93,19 @@ Modeling patterns, debugging tactics, copyable snippets.
 
 ### 11. CLI (for validation/render/export tasks)
 
-Test-run, notebook execution, export pipelines, debug flags.
+Test-run, export pipelines, debug flags.
 
-- `{{SKILL_DIR}}/docs/CLI.md`
+- `{{SKILL_DIR}}/docs/CLI/projects.md`
+- `{{SKILL_DIR}}/docs/CLI/validation.md`
+- `{{SKILL_DIR}}/docs/CLI/export.md`
+- `{{SKILL_DIR}}/docs/CLI/studio_publishing.md`
 
 ### 12. Internals — Compiler & Geometry Pipeline (for ForgeCAD developers)
 
 Semantic feature graphs, lowering strategy, compile plans. Read when working on the compiler or geometry backends.
 
 - `{{SKILL_DIR}}/docs/internals/compiler.md`
+- `{{SKILL_DIR}}/docs/internals/sketch-2d-pipeline.md`
 
 ### 13. Internals — Constraint Solver (for solver work)
 
@@ -157,20 +114,13 @@ Solver architecture, phases, Gauss-Seidel/Newton-Raphson, quality tuning.
 - `{{SKILL_DIR}}/docs/internals/constraint-solver.md`
 - `{{SKILL_DIR}}/docs/internals/constraint-solver-quality.md`
 
-### 14. Internals — Sketch 2D Pipeline
-
-2D sketch pipeline stages, constraint evaluation, winding enforcement.
-
-- `{{SKILL_DIR}}/docs/internals/sketch-2d-pipeline.md`
-
 ### 15. Project Conventions (coding standards, releases)
 
 Coding best practices, PR guidelines, release checklist, deployment.
 
 - `{{SKILL_DIR}}/docs/coding-best-practices.md`
 - `{{SKILL_DIR}}/docs/coding.md`
-- `{{SKILL_DIR}}/docs/deployment.md`
-- `{{SKILL_DIR}}/docs/RELEASING.md`
+- `{{SKILL_DIR}}/docs/blueprint-first.md`
 
 ### 16. Skill System Maintenance
 
@@ -178,3 +128,11 @@ How to add docs, maintain standard vs dev skill, build and install flow.
 
 - `{{SKILL_DIR}}/docs/guides/skill-maintenance.md`
 
+### 1b. SDF Modeling — Experimental (smooth booleans, TPMS, deformations, fromFunction)
+
+Primitives, smooth booleans, TPMS lattices, twist/bend/displace, morph, custom functions, gotchas. Experimental — slower render, lower mesh quality than B-rep.
+
+- `{{SKILL_DIR}}/docs/API/core/sdf-primitives.md`
+- `{{SKILL_DIR}}/docs/API/core/sdf-advanced.md`
+- `{{SKILL_DIR}}/docs/API/core/sdf-workflow.md`
+

package/dist-skill/SKILL.md

@@ -1,47 +1,28 @@
 ---
 name: forgecad
-description: ForgeCAD model authoring, editing, debugging, and execution guidance for .forge.js, .forge-notebook.json, SVG-import, assembly, and CLI workflows. Use when building or modifying ForgeCAD geometry, structuring multi-file projects, running notebook cells, validating scripts, or using ForgeCAD export/render tooling.
+description: ForgeCAD model authoring, editing, debugging, and execution guidance for .forge.js, SVG-import, assembly, and CLI workflows. Use when building or modifying ForgeCAD geometry, structuring multi-file projects, validating scripts, or using ForgeCAD export/render tooling.
 ---
 
 # ForgeCAD
 
-Author or modify ForgeCAD models, sketches, assemblies, notebooks, and CLI workflows. Prefer documented primitives, import rules, placement strategies, and CLI commands over inventing new APIs.
+Author or modify ForgeCAD models, sketches, assemblies, and CLI workflows. Prefer documented primitives, import rules, placement strategies, and CLI commands over inventing new APIs.
 
 ## Workflow
 
-1. Identify the artifact: `.forge.js`, `.forge-notebook.json`, SVG asset, or CLI/export task.
+1. Identify the artifact: `.forge.js`, SVG asset, or CLI/export task.
 2. Load only the docs the task needs (see Source Map below). Start from the top group, add others as needed.
 3. Default to a concrete first pass — easy iteration beats speculative design review.
 4. If an existing model is broken, replace the weak structure rather than preserving bad architecture.
-5. Validate with `forgecad run <file>` (add `--debug-imports` for import chain issues). This works for notebook preview cells too.
+5. Validate with `forgecad run <file>` (add `--debug-imports` for import chain issues).
 6. For `jointsView()` animations, keep wrapped revolute tracks continuous across branch cuts; do not assume the viewport will auto-fix `-180/180` jumps.
 
 ### Import and Composition
 
 - `require("./file.forge.js", { Param: value })` for any model file, with optional param overrides.
 - `importSvgSketch()` for SVG files (file format loader, not a module import).
-- `.withReferences()` + `.placeReference()` for reusable placement.
+- `.placeReference('bottom', [0,0,0])` to align any built-in anchor to a world coordinate; also works with custom `.withReferences()`.
 - Plain `.js` modules for shared helpers/constants (not model imports).
 
-### Notebooks
-
-Use `.forge-notebook.json` for stateful iteration and debugging. Cells share state, `show()` pins visible geometry, and the preview cell can be validated or rendered directly from the CLI.
-
-Prefer notebooks when:
-
-- the task is exploratory or the geometry strategy is still unclear
-- you are debugging booleans, placements, or assembly kinematics
-- you want to inspect intermediate shapes or sketches without rewriting the whole file
-
-Useful notebook loop:
-
-- keep stable setup in early cells and the current experiment in the preview cell
-- use `show(...)` for intermediate geometry you want pinned in the viewport
-- use `forgecad notebook view <file> preview` to inspect the notebook from the terminal
-- use `forgecad run <file>.forge-notebook.json` for preview-cell validation and spatial analysis
-- use `forgecad render <file>.forge-notebook.json` or `forgecad capture gif <file>.forge-notebook.json --list` to inspect the preview cell through the CLI
-- export to `.forge.js` when the exploratory phase is over and the structure is ready to stabilize
-
 ## Source Map
 
 Load groups top-to-bottom, stopping when you have what the task needs.
@@ -50,19 +31,9 @@ Load groups top-to-bottom, stopping when you have what the task needs.
 
 Execution model, colors, coordinate system, primitives, booleans, patterns, imports, parameters, topology, edge queries.
 
-- `{{SKILL_DIR}}/docs/API/core/reserved-terms.md`
 - `{{SKILL_DIR}}/docs/API/core/concepts.md`
-- `{{SKILL_DIR}}/docs/API/core/parameters.md`
-- `{{SKILL_DIR}}/docs/API/core/topology.md`
-- `{{SKILL_DIR}}/docs/API/core/edge-queries.md`
 - `{{SKILL_DIR}}/docs/generated/core.md`
 
-### 1b. SDF Modeling (when using smooth booleans, TPMS, deformations, or fromFunction)
-
-Primitives, smooth booleans, TPMS lattices, twist/bend/displace, morph, custom functions, gotchas.
-
-- `{{SKILL_DIR}}/docs/API/core/sdf.md`
-
 ### 2. Geometry and Positioning (when placement/orientation matters)
 
 Axis conventions, winding rules, and placement strategy.
@@ -71,21 +42,10 @@ Axis conventions, winding rules, and placement strategy.
 - `{{SKILL_DIR}}/docs/guides/geometry-conventions.md`
 - `{{SKILL_DIR}}/docs/guides/positioning.md`
 
-### 3. Sketch APIs (when the task is sketch-heavy)
+### 3. Sketch APIs
 
 2D construction, transforms, booleans, paths, on-face sketching, extrusion, anchors, text, regions.
 
-- `{{SKILL_DIR}}/docs/API/sketch/core.md`
-- `{{SKILL_DIR}}/docs/API/sketch/primitives.md`
-- `{{SKILL_DIR}}/docs/API/sketch/path.md`
-- `{{SKILL_DIR}}/docs/API/sketch/transforms.md`
-- `{{SKILL_DIR}}/docs/API/sketch/booleans.md`
-- `{{SKILL_DIR}}/docs/API/sketch/operations.md`
-- `{{SKILL_DIR}}/docs/API/sketch/on-face.md`
-- `{{SKILL_DIR}}/docs/API/sketch/extrude.md`
-- `{{SKILL_DIR}}/docs/API/sketch/anchor.md`
-- `{{SKILL_DIR}}/docs/API/sketch/text.md`
-- `{{SKILL_DIR}}/docs/API/sketch/regions.md`
 - `{{SKILL_DIR}}/docs/generated/sketch.md`
 
 ### 4. Curves and Surfacing (for lofts, sweeps, splines)
@@ -98,38 +58,31 @@ Smooth curves, Hermite splines, lofted and swept solids.
 
 Assembly graph, joint types, couplings, validation, robot export.
 
-- `{{SKILL_DIR}}/docs/API/assembly/assembly.md`
 - `{{SKILL_DIR}}/docs/generated/assembly.md`
 
 ### 6. Sheet Metal (for bent parts, K-factor, flat patterns)
 
 Bend operations, flat pattern unfolding, K-factor configuration.
 
-- `{{SKILL_DIR}}/docs/API/sheet-metal/sheet-metal.md`
 - `{{SKILL_DIR}}/docs/generated/sheet-metal.md`
 
 ### 7. Output and Export (for STL/3MF/STEP, BOM, dimensions)
 
 Mesh export, exact geometry export, bill of materials, dimension annotations.
 
-- `{{SKILL_DIR}}/docs/API/output/export.md`
-- `{{SKILL_DIR}}/docs/API/output/brep-export.md`
-- `{{SKILL_DIR}}/docs/API/output/bom.md`
-- `{{SKILL_DIR}}/docs/API/output/dimensions.md`
 - `{{SKILL_DIR}}/docs/generated/output.md`
 
 ### 8. Toolbox (fasteners and standard parts)
 
 Parametric bolts, nuts, washers, standard hardware, gears, pipes, and structural profiles.
 
-- `{{SKILL_DIR}}/docs/API/toolbox/fasteners.md`
 - `{{SKILL_DIR}}/docs/generated/lib.md`
+- `{{SKILL_DIR}}/docs/generated/wood.md`
 
 ### 9. Runtime Viewport APIs (for cut planes, jointsView, and animation playback)
 
 Viewer-only APIs such as cutPlane, explodeView, jointsView, and animation behavior.
 
-- `{{SKILL_DIR}}/docs/API/runtime/viewport.md`
 - `{{SKILL_DIR}}/docs/generated/viewport.md`
 
 ### 10. Recipes and Debugging (for patterns and troubleshooting)
@@ -140,7 +93,10 @@ Modeling patterns, debugging tactics, copyable snippets.
 
 ### 11. CLI (for validation/render/export tasks)
 
-Test-run, notebook execution, export pipelines, debug flags.
+Test-run, export pipelines, debug flags.
 
-- `{{SKILL_DIR}}/docs/CLI.md`
+- `{{SKILL_DIR}}/docs/CLI/projects.md`
+- `{{SKILL_DIR}}/docs/CLI/validation.md`
+- `{{SKILL_DIR}}/docs/CLI/export.md`
+- `{{SKILL_DIR}}/docs/CLI/studio_publishing.md`
 

package/dist-skill/docs/API/core/concepts.md

@@ -5,45 +5,28 @@ skill-order: 1
 
 # ForgeCAD Core Concepts
 
-ForgeCAD scripts are JavaScript code that returns geometry. The forge API is globally available — no imports needed.
-
-## Basic Structure
+ForgeCAD scripts are JavaScript that returns geometry. The forge API is globally available — no imports needed.
 
 ```javascript
-// 1. Declare parameters (creates UI sliders)
 const width = param("Width", 50, { min: 20, max: 100, unit: "mm" });
-
-// 2. Create geometry
-const shape = box(width, 30, 10);
-
-// 3. Return the final shape
-return shape;
+return box(width, 30, 10);
 ```
 
 ## Execution Model
 
 - Scripts re-execute on every parameter change (400ms debounce)
-- All operations are **immutable** — they return new shapes, never modify in place
-- Must return one of:
-  - A `Shape` (3D solid)
-  - A `Sketch` (2D profile — rendered flat on XY plane)
-  - A `TrackedShape` (3D solid with named faces/edges — auto-unwrapped)
-  - A `ShapeGroup` (multiple shapes/sketches grouped for joint transforms)
-  - An `Array` of shapes/sketches/groups (multi-object scene)
-  - An `Array` of `{ name, shape?, sketch?, color? }` objects (named multi-object scene)
+- All operations are **immutable** — return new shapes, never modify in place
+- Must return one of: `Shape`, `Sketch`, `ShapeGroup`, `Array` of shapes/sketches/groups, or `Array` of `{ name, shape?, sketch?, color? }`
 
-## Colors
+## Coordinate System
 
-Both `Shape` and `Sketch` support colors via `.color()`:
+Z-up right-handed: X = left/right, Y = forward/back, Z = up/down.
 
-```javascript
-const red = box(50, 50, 50).color('#ff0000');
-const blue = circle2d(25).color('#0066ff');
-```
+## Colors
 
-Colors are preserved through transforms. In boolean operations the first operand's color wins.
+`.color(hex)` works on `Shape` and `Sketch`. Colors survive transforms. In booleans the first operand's color wins.
 
-When returning multiple objects, set color per-object:
+**`union()` removes colors** — shapes merge into one solid mesh. Return named objects instead:
 
 ```javascript
 return [
@@ -52,82 +35,17 @@ return [
 ];
 ```
 
-## ⚠️ Unions Remove Colors
-
-`union()` merges shapes into one solid mesh — individual colors are lost:
-
-```javascript
-// ❌ BAD: Colors are lost after union
-const red = box(30, 30, 30).color('#ff0000');
-const blue = box(20, 20, 20).translate(30, 0, 0).color('#0066ff');
-return union(red, blue); // Result is all one color
-```
-
-Return as named objects instead to keep each color:
-
-```javascript
-// ✅ GOOD: Each object keeps its color
-return [
-  { name: "Red Box", shape: box(30, 30, 30), color: '#ff0000' },
-  { name: "Blue Box", shape: box(20, 20, 20).translate(30, 0, 0), color: '#0066ff' },
-];
-```
-
-## Coordinate System
-
-ForgeCAD uses **Z-up** right-handed coordinates:
-- **X** = left/right
-- **Y** = forward/back
-- **Z** = up/down
-
-See [coordinate-system.md](../guides/coordinate-system.md) for view mapping details.
-
 ## Face Operations
 
-Pocket, boss, and profile operations work on any planar face — identified by string name or geometric query.
-
-### Face Selection
-
-```javascript
-// Canonical names (primitives and tracked shapes)
-shape.face('top')       // topmost upward face
-shape.face('front')     // front face (-Y normal)
-
-// Geometric queries (any shape — booleans, imports, complex bodies)
-shape.face({ normal: [0, 0, 1], pick: 'largest' })   // largest upward face
-shape.face({ normal: [0, 0, 1], nearest: [50, 50] }) // nearest to XY point
-shape.faces({ normal: [0, 0, 1] })                    // all upward faces (FaceRef[])
-```
-
-Query properties: `normal`, `nearest`, `at`, `pick` (`'largest'`/`'smallest'`/`'max-z'`/...), `area` (`{ min?, max? }`).
+Shapes carry semantic face labels through their lifecycle. The flow is:
 
-### Pocket and Boss
-
-```javascript
-// Cut a pocket into the top face
-box(100, 100, 20).pocket('top', 8, { inset: 5 })
+1. **Primitives** assign canonical names — `box()` gives you `top`, `bottom`, `side-left`, etc.; `cylinder()` gives `top`, `bottom`, `side`.
+2. **Extrusions** inherit labels from the sketch and add `top`/`bottom`.
+3. **Transforms** (translate, rotate, scale, mirror) preserve all labels.
+4. **Booleans** preserve labels from the first operand where geometry survives.
 
-// Add a boss from the top face
-box(100, 100, 20).boss('top', 5, { scale: 0.6 })
-
-// Target a specific face on a complex body with a query
-const body = box(100, 100, 20).pocket('top', 10, { inset: 5 });
-body.boss({ normal: [0, 0, 1], pick: 'smallest' }, 5)  // boss from pocket floor
-```
-
-Options: `inset` (shrink boundary, mm), `scale` (uniform scale, e.g. 0.8), `join` (`'Round'`/`'Square'`/`'Miter'`).
-
-### Face Profile
-
-Extract a face's 2D boundary as a `Sketch` for manual workflows:
-
-```javascript
-const profile = faceProfile(box(100, 100, 20), 'top');
-const tool = profile.offset(-5).extrude(8);  // shrink + extrude manually
-```
+You resolve labels to geometry with `.face(name)` or `.face(query)` — see the Shape class docs for the full query API. Operations like `.pocket()`, `.boss()`, `.hole()`, and `faceProfile()` all consume face references.
 
 ## SDF Modeling
 
-For organic shapes, smooth blending, TPMS lattices, and surface deformations, ForgeCAD provides a parallel SDF (Signed Distance Field) pipeline via the `sdf` namespace. SDF shapes convert to regular `Shape` objects via `.toShape()`.
-
-See [sdf.md](sdf.md) for the full reference — primitives, smooth booleans, TPMS, twist/bend/displace, custom functions, and workflow tips.
+For organic shapes, smooth blending, TPMS lattices, and surface deformations. SDF shapes convert via `.toShape()`. See [sdf-primitives.md](sdf-primitives.md).

package/dist-skill/docs/CLI/export.md

@@ -0,0 +1,91 @@
+---
+skill-group: cli
+skill-order: 3
+---
+
+# ForgeCAD CLI: Export Commands
+
+## SVG Export
+
+```bash
+forgecad export svg examples/constraints/01-fully-constrained-rect.forge.js [output.svg]
+```
+
+Pure Node — no browser needed. Runs the sketch script through the forge engine and converts polygons to SVG paths.
+
+## STEP / BREP Export (exact subset, CadQuery)
+
+```bash
+forgecad export step examples/api/brep-exportable.forge.js [--output out/demo.step] [--python 3.11] [--uv /path/to/uv]
+forgecad export brep examples/api/brep-exportable.forge.js
+forgecad export step examples/chess-set.forge.js --allow-faceted
+```
+
+`uv`-first: provisions CadQuery automatically. Exact-subset only by default — fails with a reason rather than silently exporting degraded geometry. With `--allow-faceted`, unsupported mesh solids export as faceted OCCT solids (tessellation-driven, not exact replay).
+
+The maintained feature matrix: `docs/permanent/API/output/brep-export.md`.
+
+## G-code Toolpath Export
+
+```bash
+forgecad export gcode examples/gcode/parametric-vase.forge.js [--output out/vase.gcode]
+```
+
+The script must return a `GCodeBuilder` (from the `gcode()` factory). This is a toolpath scripting API, not a slicer — you define print movements in code. See `docs/permanent/API/output/gcode.md` for the full API.
+
+## SDF Robot Export (Gazebo)
+
+```bash
+forgecad export sdf examples/api/sdf-rover-demo.forge.js [--output out/forge_scout]
+```
+
+Writes a Gazebo-friendly package: `model.sdf`, `model.config`, `meshes/*.stl`, optional world file. Script must call `robotExport({...})` with an `assembly(...)` graph.
+
+Launch flow (macOS — use split `-s`/`-g`):
+```bash
+export GZ_SIM_RESOURCE_PATH="$PWD/out/forge_scout/models${GZ_SIM_RESOURCE_PATH:+:$GZ_SIM_RESOURCE_PATH}"
+gz sim -s -r out/forge_scout/worlds/forge_scout_trial.sdf
+gz sim -g out/forge_scout/worlds/forge_scout_trial.sdf
+```
+
+## URDF Export
+
+```bash
+forgecad export urdf examples/api/sdf-rover-demo.forge.js
+```
+
+## PNG Render (requires Chrome/Puppeteer)
+
+```bash
+forgecad render examples/cup.forge.js [output.png]
+forgecad render examples/cup.forge.js out/scene.png --scene '<json from viewport>'
+```
+
+Options: `--angles <front,side,top,iso>`, `--size <px>`, `--port <n>`, `--camera <spec>`, `--scene <json>`, `--background <color>`, `--chrome-path <path>`.
+
+## Animated Capture (GIF or MP4, requires Chrome)
+
+```bash
+forgecad capture gif examples/cup.forge.js [output.gif]
+forgecad capture mp4 examples/cup.forge.js [output.mp4]
+forgecad capture mp4 examples/api/runtime-joints-view.forge.js out/step.mp4 --capture animation --animation Step
+forgecad capture gif examples/3d-printer.forge.js out/section.gif --cut-plane "Front Section"
+```
+
+`--list` prints available animation clips and cut planes. Uses `ffmpeg` when available (better GIF colors, H.264 MP4); falls back to pure-JS GIF encoder.
+
+Key options: `--capture <orbit|animation>`, `--animation <name>`, `--cut-plane <name>`, `--camera <spec>`, `--scene <json>`, `--size <px>`, `--fps <n>`, `--frames-per-turn <n>`, `--quality <default|live|high>`.
+
+Use `Copy CLI --scene` from the View Panel to grab the current viewport framing and paste into `render` or `capture`.
+
+## PDF Report
+
+```bash
+forgecad export report examples/cup.forge.js [output.pdf] [--dim-angle-tol 18]
+```
+
+Generates a searchable PDF with BOM page, combined model page, and per-component pages. Dimensions included per view when their axis aligns with that view's projection plane (within `--dim-angle-tol` degrees, default 12).
+
+## STL Export
+
+Available in the browser UI via the Export panel (binary STL).

package/dist-skill/docs/CLI/projects.md

@@ -0,0 +1,107 @@
+---
+skill-group: cli
+skill-order: 1
+---
+
+# ForgeCAD CLI: Projects & Setup
+
+## Install
+
+```bash
+npm install -g forgecad
+# Developers working on ForgeCAD itself:
+npm install && npm link
+```
+
+## When to use what
+
+| Context | Use |
+|---------|-----|
+| Using ForgeCAD as a tool | `forgecad *` commands |
+| Developing ForgeCAD itself | `npm run dev` / `npm run build` |
+| CI / publishing | `npm run build && npm run test:full` |
+
+## Dev vs production server
+
+```bash
+forgecad dev [path]        # Vite dev server, live reload
+forgecad studio [path]     # Static server for production build (requires dist/)
+```
+
+Both accept `--blank`, `--port <n>`, `--host`, `--open`, `--strict-port`.
+
+## Licensing
+
+```bash
+forgecad license                    # Show license status
+forgecad license activate <key>     # Activate a Pro license key
+forgecad license deactivate         # Remove license
+```
+
+| Tier | Included |
+|------|----------|
+| Free | dev, studio, run, render, export stl/3mf/svg, all checks, debug |
+| Pro  | export step/brep, render-hq, capture gif/mp4, gcode, report, cutting-layout, sdf, urdf, sketch-pdf |
+
+## Authentication
+
+```bash
+forgecad login                          # Interactive login
+forgecad login --server http://localhost:5174
+forgecad logout
+forgecad whoami                         # Show user, server, and license status
+```
+
+Credentials stored in `~/.forgecad/auth.json`.
+
+## Project Management
+
+```bash
+forgecad project init "My Project"      # Create on server + link current directory
+forgecad project clone my-project       # Download into ./my-project/
+forgecad project push [--force]         # Upload local changes
+forgecad project pull [--force]         # Download remote changes
+forgecad project status                 # Show local vs remote diff
+forgecad project list
+forgecad project info
+forgecad project rename "New Name"
+forgecad project set-visibility public  # private|shared|public
+forgecad project delete [--force]
+forgecad project open
+```
+
+Projects are linked to remote via `forgecad.json`.
+
+## File Management (Remote)
+
+```bash
+forgecad file list [path]
+forgecad file read <path>
+forgecad file save <path>               # Upload local file
+forgecad file save <path> --content "code here"
+cat model.forge.js | forgecad file save model.forge.js --stdin
+forgecad file delete <path> [--force]
+forgecad file rename <old> <new>
+forgecad file mkdir <path>
+forgecad file copy <source-slug> <path> [--dest <dest-path>]
+```
+
+Requires the current directory to have `forgecad.json`.
+
+## Member Management
+
+```bash
+forgecad project members
+forgecad project add-member alice@example.com          # editor by default
+forgecad project add-member bob@example.com --role viewer
+forgecad project remove-member alice@example.com
+forgecad project set-role bob@example.com editor
+```
+
+Roles: **owner** (full control), **editor** (read/write), **viewer** (read-only).
+
+## Shell Autocomplete
+
+```bash
+forgecad completion bash   # or zsh / fish
+```