chore: set up changesets for versioning and changelog generation

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.3/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "joesobo/CodeGraphyV4" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to CodeGraphy will be documented in this file.
+
+This project uses [Changesets](https://github.com/changesets/changesets) for versioning.
+
+## 0.1.0 (Unreleased)
+
+Initial development release. Core features:
+
+- Interactive 2D/3D force-directed graph visualization of codebases
+- Multi-language support via plugin system (TypeScript/JS, Python, C#, GDScript, Markdown)
+- Plugin API v2 with rules, decorations, context menus, and event bus
+- Three graph views: Connections, Depth Graph, Folder
+- DAG layout modes: Default, Radial Out, Top Down, Left to Right
+- Node size modes: Connections, File Size, Access Count, Uniform
+- Settings panel with physics tuning, color groups, filters, and display options
+- Toolbar with view/layout/dimension/node-size toggles and action buttons
+- Context menu with file operations (open, rename, delete, create, favorite, exclude)
+- Undo/redo support for destructive actions
+- Timeline playback for git history visualization
+- Export to PNG, SVG, JPEG, JSON, Markdown
+- Keyboard shortcuts for navigation and view cycling

CLAUDE.md

@@ -41,6 +41,42 @@ Primary locations:
 - Prefer targeted test runs while iterating, then run full `pnpm run test`.
 - Pre-commit runs lint-staged + typecheck, so keep staged changes clean.
 
+## Changeset Workflow
+
+This project uses [Changesets](https://github.com/changesets/changesets) for versioning and changelog generation.
+
+### When to add a changeset
+
+Add a changeset when a PR includes **user-facing changes**: new features, bug fixes, behavior changes, or removed functionality. Skip changesets for internal refactors, test-only changes, CI updates, or documentation fixes that don't affect the product.
+
+### How to add a changeset
+
+Run `pnpm changeset` and follow the prompts, or create a file manually in `.changeset/`:
+
+```md
+---
+"@codegraphy/extension": minor
+---
+
+Add node size toggle to the toolbar with four sizing modes
+```
+
+Bump types:
+- `patch` — bug fixes, small tweaks
+- `minor` — new features, enhancements
+- `major` — breaking changes
+
+### Writing good changeset descriptions
+
+- Write from the **user's perspective**, not implementation details.
+- One clear sentence describing what changed and why it matters.
+- Good: "Add node size toggle to the toolbar with four sizing modes"
+- Bad: "Refactor NodeSizeToggle.tsx to use postMessage and extract to toolbar/ directory"
+
+### Updating changesets
+
+If a PR is updated after the changeset was written, update the changeset file to reflect the final state of the change. The changeset should describe the PR as merged, not the incremental steps.
+
 ## Trello Task Execution Workflow
 
 When assigned a Trello card, follow this process end-to-end:

package.json

@@ -22,6 +22,8 @@
 		"test:watch": "pnpm --filter @codegraphy/extension run test:watch",
 		"lint": "turbo run lint && pnpm run lint:playwright",
 		"lint:playwright": "eslint tests/playwright --max-warnings=0",
+		"changeset": "changeset",
+		"version-packages": "changeset version",
 		"typecheck": "turbo run typecheck",
 		"typecheck:extension": "pnpm --filter @codegraphy/extension run typecheck",
 		"typecheck:plugin-api": "pnpm --filter @codegraphy/plugin-api run typecheck",
@@ -422,6 +424,8 @@
 		}
 	},
 	"devDependencies": {
+		"@changesets/changelog-github": "^0.6.0",
+		"@changesets/cli": "^2.30.0",
 		"@eslint/js": "^9.0.0",
 		"@playwright/test": "^1.58.2",
 		"@testing-library/jest-dom": "^6.2.0",

packages/plugin-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-api",
-  "version": "2.0.0",
+  "version": "0.1.0",
   "description": "Type definitions for CodeGraphy plugins",
   "type": "module",
   "sideEffects": false,

packages/plugin-csharp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-csharp",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "private": true,
   "description": "CodeGraphy csharp plugin",
   "scripts": {

packages/plugin-godot/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-godot",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "private": true,
   "description": "CodeGraphy godot plugin",
   "scripts": {

packages/plugin-markdown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-markdown",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "private": true,
   "description": "CodeGraphy markdown plugin",
   "scripts": {

packages/plugin-python/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-python",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "private": true,
   "description": "CodeGraphy python plugin",
   "scripts": {

packages/plugin-typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegraphy/plugin-typescript",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "private": true,
   "description": "CodeGraphy typescript plugin",
   "scripts": {