glyphsmith 0.1.0

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "glyphsmith",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "glyphsmith": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.ja.md",
+    "LICENSE",
+    "skills",
+    "web"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build-cli.mjs",
+    "check-types": "tsc --noEmit",
+    "dev": "pnpm run build && node dist/index.js host --example playground",
+    "dev:icons": "pnpm run build && node dist/index.js host --example glyphsmith",
+    "prepack": "pnpm -w run build:cli"
+  },
+  "devDependencies": {
+    "@glyphsmith/ast": "workspace:*",
+    "@glyphsmith/mcp": "workspace:*",
+    "@glyphsmith/svg": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
+    "@types/node": "^22",
+    "hono": "^4.12.23",
+    "typescript": "5.9.2"
+  }
+}

package/skills/glyphsmith/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: glyphsmith
+description: GlyphSmith project authoring, editing, MCP coordination, Geometry AST, patch workflows, examples, and CLI development guidance. Use when working with GlyphSmith projects, drawing or modifying SVG-equivalent geometry, configuring agent skills/MCP, or deciding whether to use MCP versus offline .gs.json edits.
+---
+
+# GlyphSmith
+
+Use this skill when working on a GlyphSmith project, especially through an active GlyphSmith MCP/editor session.
+
+GlyphSmith is a Geometry AST based SVG editor. Treat SVG text as import/export format only.
+
+## Rules
+
+* Read and write Geometry AST project data, not raw SVG strings.
+* Prefer patch operations for small edits.
+* Keep one page equivalent to one SVG document.
+* Check `projectPrompt` before creating or editing generated artwork, and follow it as the project-wide art direction when present.
+* Use MCP tools for an active editor session when they are available.
+* Default rule: do not directly edit `.gs.json`.
+* While the GlyphSmith CLI host or MCP server is running, always use MCP tools so the editor, revision, autosave, and WebSocket sync stay consistent.
+* Direct `.gs.json` edits are fallback-only for offline workflows, such as examples, fixtures, migrations, or cases where no active editor/MCP host is available.
+* If offline direct edits are unavoidable, preserve project/page metadata, make minimal Geometry AST changes, and avoid rewriting the whole project.
+
+## Related Skills
+
+Use these focused GlyphSmith skills when the task needs their details:
+
+* `glyphsmith-mcp`: active editor sessions, MCP resources/tools, patch application, selection, page operations, and SVG export through the host.
+* `glyphsmith-ast`: Geometry AST schema, node fields, path segments, text, groups, and project/page structure.
+* `glyphsmith-patch`: patch operation shapes and small edit patterns for Geometry AST changes.
+
+For active editor work, prefer `glyphsmith-mcp` first, then load `glyphsmith-ast` or `glyphsmith-patch` only when schema or patch details are needed.
+
+## Examples
+
+Examples are first-class projects:
+
+```txt
+examples/playground.gs.json
+examples/glyphsmith.gs.json
+```
+
+Use `pnpm run dev` for the playground project.
+Use `pnpm run dev:icons` for the official GlyphSmith icon set.
+Do not hardcode assumptions about a specific example project.
+
+## Installation
+
+Install GlyphSmith skills into agent skill directories with:
+
+```bash
+glyphsmith skills install codex
+glyphsmith skills install claude
+```
+
+Use `glyphsmith skills install claude --project <project-dir>` for project-local Claude skills.
+
+Register the default local MCP endpoint with:
+
+```bash
+glyphsmith mcp install codex --url http://127.0.0.1:6202/mcp
+glyphsmith mcp install claude --url http://127.0.0.1:6202/mcp
+```

package/skills/glyphsmith-ast/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: glyphsmith-ast
+description: GlyphSmith Geometry AST schema guidance for project files, pages, documents, groups, paths, segments, shapes, text nodes, styling fields, and SVG-compatible geometry. Use when inspecting or constructing Geometry AST data for GlyphSmith.
+---
+
+# GlyphSmith AST
+
+Use this skill when inspecting or changing GlyphSmith Geometry AST data.
+
+## Geometry AST
+
+The project file is a `GlyphSmithProject`.
+
+Do not directly edit `.gs.json` during an active GlyphSmith editor/MCP session. Use MCP tools for active sessions, and treat direct project-file edits as an offline fallback for examples, fixtures, or migrations.
+
+```txt
+GlyphSmithProject
+└ Page[]
+  └ GeometryDocument
+    └ GeometryNode tree
+```
+
+Supported node concepts include groups, paths, rectangles, circles, ellipses, polygons, polylines, lines, and text.
+
+Path geometry must be normalized into segments. Do not store only raw SVG path strings.
+
+Groups are normal Geometry AST nodes:
+
+```json
+{
+  "id": "group-1",
+  "type": "group",
+  "name": "Group",
+  "children": []
+}
+```
+
+Text is stored as plain text in `TextNode.text`, not as raw SVG markup.
+Line breaks are represented with `\n`.
+
+```json
+{
+  "id": "text-1",
+  "type": "text",
+  "x": 128,
+  "y": 160,
+  "text": "GlyphSmith\nIcon",
+  "fill": "#111827",
+  "fontFamily": "Inter, system-ui, sans-serif",
+  "fontSize": 24,
+  "fontWeight": "700",
+  "textAnchor": "middle"
+}
+```
+
+## Segment Rules
+
+Supported path segment concepts:
+
+* Line
+* Cubic Bezier
+* Quadratic Bezier
+* Arc
+
+Spline-like editor tools may generate cubic Bezier geometry internally.
+
+Segment shapes:
+
+```json
+{ "type": "line", "to": { "x": 240, "y": 160 } }
+```
+
+```json
+{
+  "type": "quadratic",
+  "control": { "x": 180, "y": 80 },
+  "to": { "x": 320, "y": 160 }
+}
+```
+
+Stroke style supports SVG-style cap and join values:
+
+```json
+{
+  "fill": "none",
+  "stroke": "#111827",
+  "strokeWidth": 32,
+  "strokeLinecap": "round",
+  "strokeLinejoin": "round"
+}
+```
+
+```json
+{
+  "type": "cubic",
+  "control1": { "x": 160, "y": 80 },
+  "control2": { "x": 320, "y": 280 },
+  "to": { "x": 400, "y": 160 }
+}
+```
+
+```json
+{
+  "type": "arc",
+  "rx": 96,
+  "ry": 96,
+  "xAxisRotation": 0,
+  "largeArc": false,
+  "sweep": true,
+  "to": { "x": 320, "y": 240 }
+}
+```

package/skills/glyphsmith-mcp/SKILL.md

@@ -0,0 +1,294 @@
+---
+name: glyphsmith-mcp
+description: GlyphSmith MCP workflow guidance for active editor sessions, local host endpoints, resources, tools, page/document reads, patch application, selection-aware edits, SVG export, and project save behavior. Use when a running GlyphSmith CLI host or MCP endpoint is available.
+---
+
+# GlyphSmith MCP
+
+Use this skill when an active GlyphSmith editor session exposes a local MCP endpoint.
+
+## Workflow
+
+1. Read the active project or page through MCP resources/tools.
+2. Generate small patch operations against Geometry AST.
+3. Apply patches through MCP.
+4. Re-read the affected document to confirm the result.
+
+## Rules
+
+* Do not regenerate a whole SVG when a patch is enough.
+* Do not edit raw SVG strings for active editor changes.
+* Treat `.gs.json` as an implementation detail while the GlyphSmith CLI host is active.
+* Do not directly edit `.gs.json` during active sessions. Use MCP tools so project revisions, autosave, and WebSocket clients stay synchronized.
+* Prefer page-scoped operations.
+* Keep comments as first-class instructions for agents.
+* Before drawing or editing generated artwork, read `glyphsmith://project` or call `project_get` and follow `project.projectPrompt` when present.
+
+## Expected Local Host
+
+The CLI starts the editor UI and host server locally.
+
+```txt
+Editor: http://127.0.0.1:6201
+Host:   ws://127.0.0.1:6202/ws
+MCP:    http://127.0.0.1:6202/mcp
+```
+
+If the default port is unavailable, use the actual MCP URL printed by the CLI.
+
+For monorepo development with `pnpm run dev`, the same default ports are used:
+
+```txt
+Editor: http://localhost:6201
+Host:   ws://localhost:6202/ws
+MCP:    http://localhost:6202/mcp
+```
+
+`pnpm run dev` opens `examples/playground.gs.json`.
+`pnpm run dev:icons` opens `examples/glyphsmith.gs.json`.
+
+Register the endpoint with local agents when needed.
+
+```bash
+glyphsmith mcp install codex --url http://127.0.0.1:6202/mcp
+glyphsmith mcp install claude --url http://127.0.0.1:6202/mcp
+```
+
+## Resources
+
+```txt
+glyphsmith://project
+glyphsmith://pages
+glyphsmith://active-document
+glyphsmith://document/{pageId}
+glyphsmith://comments
+glyphsmith://selection
+glyphsmith://skill-guide
+```
+
+## Tools
+
+```txt
+project_get
+pages_list
+document_get
+selection_get
+comments_get
+patch_apply
+patches_apply
+node_insert
+node_update
+node_delete
+node_move
+document_update
+path_create
+path_segment_append
+path_segment_update
+path_segment_delete
+path_set_closed
+page_add
+page_duplicate
+page_delete
+page_set_active
+svg_export
+project_save
+```
+
+Use `patch_apply` with `dryRun: true` before risky geometry changes.
+Use `patches_apply` when drawing multiple shapes in one update.
+Use `node_insert`, `node_update`, `node_delete`, and `node_move` for simple create/edit/delete/move operations.
+Use `path_create` and `path_segment_*` for path drawing or segment-level curve edits.
+Use `node_insert` / `node_update` for `text` and `group` nodes as normal Geometry AST nodes.
+Pass `revision` when mutating if the current revision is known.
+`glyphsmith://selection` reflects the current editor selection when the web editor is connected to the CLI host.
+
+## Drawing Workflow
+
+When asked to draw SVG content:
+
+1. Call `project_get` or read `glyphsmith://project` to check `projectPrompt` and revision.
+2. Call `document_get` to read the active document when needed.
+3. Use `document_update` if the requested canvas size differs.
+4. Use `patches_apply` or `node_insert` to add Geometry AST nodes.
+5. Re-read with `document_get`.
+6. Use `svg_export` when the user asks for SVG output.
+
+Example `patches_apply` arguments:
+
+```json
+{
+  "revision": "<current-revision>",
+  "patches": [
+    {
+      "op": "updateDocument",
+      "changes": {
+        "width": 512,
+        "height": 512,
+        "name": "Simple Icon"
+      }
+    },
+    {
+      "op": "insert",
+      "parentId": "root",
+      "node": {
+        "id": "icon-bg",
+        "type": "rect",
+        "x": 48,
+        "y": 48,
+        "width": 416,
+        "height": 416,
+        "rx": 48,
+        "ry": 48,
+        "style": {
+          "fill": "#0f172a",
+          "stroke": "#38bdf8",
+          "strokeWidth": 8
+        }
+      }
+    },
+    {
+      "op": "insert",
+      "parentId": "root",
+      "node": {
+        "id": "icon-circle",
+        "type": "ellipse",
+        "cx": 256,
+        "cy": 256,
+        "rx": 120,
+        "ry": 120,
+        "style": {
+          "fill": "#22c55e",
+          "stroke": "none"
+        }
+      }
+    }
+  ]
+}
+```
+
+Example edit arguments:
+
+```json
+{
+  "target": "icon-circle",
+  "changes": {
+    "rx": 96,
+    "ry": 96,
+    "style": {
+      "fill": "#f97316",
+      "stroke": "#fff7ed",
+      "strokeWidth": 6
+    }
+  }
+}
+```
+
+Example delete arguments:
+
+```json
+{
+  "target": "icon-circle"
+}
+```
+
+## Path Drawing
+
+Create paths with normalized segments, not raw SVG `d` strings.
+
+Example `path_create` arguments:
+
+```json
+{
+  "id": "logo-curve",
+  "start": { "x": 96, "y": 320 },
+  "closed": false,
+  "style": {
+    "fill": "none",
+    "stroke": "#38bdf8",
+    "strokeWidth": 10
+  },
+  "segments": [
+    {
+      "type": "cubic",
+      "control1": { "x": 160, "y": 160 },
+      "control2": { "x": 320, "y": 480 },
+      "to": { "x": 416, "y": 280 }
+    }
+  ]
+}
+```
+
+Append a line segment:
+
+```json
+{
+  "target": "logo-curve",
+  "segment": {
+    "type": "line",
+    "to": { "x": 448, "y": 360 }
+  }
+}
+```
+
+Append a quadratic segment:
+
+```json
+{
+  "target": "logo-curve",
+  "segment": {
+    "type": "quadratic",
+    "control": { "x": 360, "y": 120 },
+    "to": { "x": 448, "y": 240 }
+  }
+}
+```
+
+Append an arc segment:
+
+```json
+{
+  "target": "logo-curve",
+  "segment": {
+    "type": "arc",
+    "rx": 96,
+    "ry": 96,
+    "xAxisRotation": 0,
+    "largeArc": false,
+    "sweep": true,
+    "to": { "x": 320, "y": 384 }
+  }
+}
+```
+
+Replace the first segment:
+
+```json
+{
+  "target": "logo-curve",
+  "index": 0,
+  "segment": {
+    "type": "cubic",
+    "control1": { "x": 128, "y": 180 },
+    "control2": { "x": 300, "y": 420 },
+    "to": { "x": 400, "y": 300 }
+  }
+}
+```
+
+Delete a segment:
+
+```json
+{
+  "target": "logo-curve",
+  "index": 1
+}
+```
+
+Close a path:
+
+```json
+{
+  "target": "logo-curve",
+  "closed": true
+}
+```