chore: add changesets alpha setup (#44)

Author: mahyarmlk

.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,15 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "privatePackages": {
+    "version": false,
+    "tag": false
+  }
+}

README.md

@@ -276,7 +276,7 @@ Current limitations include:
 * No backend persistence yet
 * No real resource cache policy yet
 * No DevTools package yet
-* No package publishing flow yet
+* No automated publish workflow yet (Changesets is configured, release workflow pending)
 * Demo side panels use manual DOM
 * Demo diagnostics panel uses `MutationObserver`
 * Demo data is in memory only

docs/Release-Readiness.md

@@ -4,7 +4,7 @@
 
 Intent is in early experimental development. No packages have been published to npm. No GitHub Releases have been created.
 
-The repository has five workspace packages under `packages/*`, all at version `0.1.0`, all using `workspace:*` dependency references. The codebase is functional and validated by CI, but several metadata and workflow steps are missing before a first alpha release.
+The repository has five workspace packages under `packages/*`. The four publishable packages are at version `0.1.0-alpha.0`. The private server package remains at `0.1.0`. All use `workspace:*` dependency references. The codebase is functional and validated by CI. Changesets is installed and configured. The remaining blocker before a first alpha release is the release workflow and npm publish automation.
 
 Four packages are intended for first-alpha publishing. `packages/server` is a private workspace package for now.
 
@@ -226,15 +226,16 @@ Do not manually create GitHub Releases.
 ## First alpha release checklist
 
 - [x] npm scope is `@intent-framework/*` — `intent-framework` org created, packages renamed
-- [ ] Reconfirm MIT is the intended public license before publishing
+- [x] MIT confirmed as intended public license
 - [x] Confirm package metadata (`repository` field in all packages)
 - [x] Server is private — not a publishing blocker
-- [ ] Confirm package exports (all point to correct `dist/` paths — already correct)
-- [ ] Confirm package files (`files: ["dist"]` — already correct)
-- [ ] Confirm declaration files (`dist/index.d.ts` exists — already correct)
-- [ ] Run clean-dist validation (`rm -rf packages/*/dist examples/*/dist && pnpm test && pnpm typecheck && pnpm build && pnpm lint`)
-- [ ] Run `pnpm pack:check`
-- [ ] Add Changesets (`pnpm add -Dw @changesets/cli && pnpm changeset init`)
+- [x] Package exports point to correct `dist/` paths
+- [x] Package `files: ["dist"]` is correct
+- [x] Declaration files (`dist/index.d.ts`) exist after build
+- [x] Clean-dist validation passes
+- [x] `pnpm pack:check` passes
+- [x] Changesets installed and configured
+- [x] First alpha package versions set to `0.1.0-alpha.0`
 - [ ] Add release workflow (GitHub Action for Changesets)
 - [ ] Publish first alpha (`pnpm changeset publish`)
 - [ ] Create GitHub Release (automatic via Changesets, or manual)
@@ -243,7 +244,7 @@ Do not manually create GitHub Releases.
 
 - repository fields are present
 - GitHub repository home is https://github.com/intent-framework/intent
-- remaining first-alpha blockers: release workflow not yet added, alpha prerelease versioning not configured, and human confirmation that MIT is the intended public license
+- remaining first-alpha blocker after this PR: Release workflow not yet added, including npm publish automation and required secrets.
 
 ## Future server-package decisions
 
@@ -254,9 +255,8 @@ Do not manually create GitHub Releases.
 
 - Do not publish any package to npm.
 - Do not create a GitHub Release.
-- Do not add Changesets yet — wait until the audit blockers are resolved.
 - Do not add a release GitHub Action yet.
-- Do not change versions or public APIs.
+- Do not change runtime or public APIs.
 - Do not add new dependencies unless required for a specific task.
 
 ## Pack check command

package.json

@@ -6,13 +6,17 @@
     "test": "pnpm -r test",
     "typecheck": "tsc -p tsconfig.typecheck.json",
     "lint": "tsc -p tsconfig.typecheck.json",
+    "changeset": "changeset",
+    "version:packages": "changeset version",
+    "release:alpha": "pnpm build && pnpm pack:check && changeset publish --tag alpha",
     "pack:check": "pnpm -r --filter @intent-framework/core --filter @intent-framework/dom --filter @intent-framework/router --filter @intent-framework/testing exec npm pack --dry-run",
     "dev:web-basic": "pnpm --dir examples/web-basic dev"
   },
   "engines": {
     "node": ">=18"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
     "typescript": "^5.9.3"
   }
 }

packages/core/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0",
+  "version": "0.1.0-alpha.0",
   "description": "Platformless semantic graph and runtime for Intent applications",
   "license": "MIT",
   "repository": {

packages/dom/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0",
+  "version": "0.1.0-alpha.0",
   "description": "DOM materializer for Intent screens and router",
   "license": "MIT",
   "repository": {

packages/router/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0",
+  "version": "0.1.0-alpha.0",
   "description": "Typed route definitions and navigation for Intent",
   "license": "MIT",
   "repository": {

packages/testing/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0",
+  "version": "0.1.0-alpha.0",
   "description": "Semantic test harness for Intent screens",
   "license": "MIT",
   "repository": {