gemstack-land · suleimansh · Jul 3, 2026 · Jul 3, 2026
diff --git a/.changeset/framework-preflight.md b/.changeset/framework-preflight.md
diff --git a/.changeset/framework-serve-gate.md b/.changeset/framework-serve-gate.md
diff --git a/.changeset/framework-session-link.md b/.changeset/framework-session-link.md
diff --git a/.changeset/localrunner-adopt.md b/.changeset/localrunner-adopt.md
diff --git a/examples/autopilot-quickstart/CHANGELOG.md b/examples/autopilot-quickstart/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @gemstack/example-autopilot-quickstart
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [d72accd]
+  - @gemstack/ai-autopilot@0.5.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/autopilot-quickstart/package.json b/examples/autopilot-quickstart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@gemstack/example-autopilot-quickstart",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Runnable end-to-end quickstart for @gemstack/ai-autopilot: personas + Supervisor + runner + surfaces composed into one build-a-feature flow, offline via AiFake.",
   "type": "module",

diff --git a/examples/bootstrap-quickstart/CHANGELOG.md b/examples/bootstrap-quickstart/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @gemstack/example-bootstrap-quickstart
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [d72accd]
+  - @gemstack/ai-autopilot@0.5.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/bootstrap-quickstart/package.json b/examples/bootstrap-quickstart/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@gemstack/example-bootstrap-quickstart",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Runnable capstone for @gemstack/ai-autopilot: preset detection + Bootstrap (scope → architect → build → full-fledged loop → deploy) + scale mode, streamed over surfaces, offline via AiFake + FakeRunner.",
   "type": "module",

diff --git a/packages/ai-autopilot/CHANGELOG.md b/packages/ai-autopilot/CHANGELOG.md
@@ -1,5 +1,17 @@
 # @gemstack/ai-autopilot
 
+## 0.5.0
+
+### Minor Changes
+
+- d72accd: feat(runner): `LocalRunner.adopt(dir)` binds an existing directory as the workspace
+
+  Adopt a directory that already exists instead of booting a fresh temp one. The
+  session reads, execs, starts, and previews inside it exactly like a booted
+  session, but `dispose` does not delete it (the directory belongs to the caller).
+  Fills a real gap in the runner seam: running or verifying code that another tool
+  already wrote to disk.
+
 ## 0.4.0
 
 ### Minor Changes

diff --git a/packages/ai-autopilot/package.json b/packages/ai-autopilot/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@gemstack/ai-autopilot",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Orchestration for @gemstack/ai-sdk agents: a Supervisor that plans, dispatches subagents (bounded concurrency + budget guardrails), and synthesizes the result.",
   "keywords": [
     "ai",

diff --git a/packages/framework/CHANGELOG.md b/packages/framework/CHANGELOG.md
@@ -1,5 +1,32 @@
 # @gemstack/framework
 
+## 0.2.0
+
+### Minor Changes
+
+- d31a260: feat: preflight checks + `framework doctor`
+
+  A live run now checks its prerequisites first and fails early with a clear fix
+  ("`claude` not found - install Claude Code ...") instead of a cryptic mid-run
+  spawn error. Adds a `framework doctor` command that reports the checks, and a
+  `--skip-preflight` escape hatch. `--fake` never runs preflight (it needs no CLI).
+
+- d72accd: feat: `--serve` gates the loop on the app actually running
+
+  When `--serve <cmd>` is set, the production-grade checklist no longer trusts only
+  the agent's review: it adopts the agent's workspace, installs/builds/starts the
+  app, and fetches it. A boot failure or a 5xx becomes a blocker the loop hands
+  back to the agent to fix, so "production-grade" means it really serves. Adds
+  `--serve-install`, `--serve-build`, `--serve-port`, `--serve-path`, the
+  `serve` option on `runFramework`, and streams serve progress to the dashboard.
+
+- c4545c2: Surface the live agent session on the dashboard. The wrapped agent's real session id is captured once the first turn returns and streamed as a new `session-update` event, so the dashboard header shows the live session (and the terminal prints it). `--session-link` now accepts a `{sessionId}` template that resolves to a real URL once the id is known; a literal URL still shows immediately.
+
+### Patch Changes
+
+- Updated dependencies [d72accd]
+  - @gemstack/ai-autopilot@0.5.0
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/framework/package.json b/packages/framework/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@gemstack/framework",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The (AI) Framework: turnkey, zero-config AI orchestration that wraps a coding-agent CLI (Claude Code) as a black box and takes you from an idea to a running app. Vite for AI.",
   "keywords": [
     "ai",