create-astrale-domain 0.3.0-beta.63 → 0.3.0-beta.65

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.3.0-beta.65](https://github.com/astrale-os/sdk/compare/create-astrale-domain-v0.3.0-beta.64...create-astrale-domain-v0.3.0-beta.65) (2026-08-28)
+
+
+### Features
+
+* add coordinated Domain development sessions ([#300](https://github.com/astrale-os/sdk/issues/300)) ([102104f](https://github.com/astrale-os/sdk/commit/102104f1ed55333f5892db23c036578aa0ffd2e1))
+* **tooling:** keep frontend composition application-owned ([#310](https://github.com/astrale-os/sdk/issues/310)) ([31e9bb6](https://github.com/astrale-os/sdk/commit/31e9bb6de256ef9cdbcdb0296abb973086f11ff0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @astrale-os/adapter-astrale bumped to 0.5.0-beta.65
+    * @astrale-os/adapter-cloudflare bumped to 0.5.0-beta.72
+  * devDependencies
+    * @astrale-os/sdk bumped to 0.5.0-beta.69
+
+## [0.3.0-beta.64](https://github.com/astrale-os/sdk/compare/create-astrale-domain-v0.3.0-beta.63...create-astrale-domain-v0.3.0-beta.64) (2026-08-28)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @astrale-os/adapter-astrale bumped to 0.5.0-beta.64
+    * @astrale-os/adapter-cloudflare bumped to 0.5.0-beta.71
+  * devDependencies
+    * @astrale-os/sdk bumped to 0.5.0-beta.68
+
 ## [0.3.0-beta.63](https://github.com/astrale-os/sdk/compare/create-astrale-domain-v0.3.0-beta.62...create-astrale-domain-v0.3.0-beta.63) (2026-08-28)
 
 

package/dist/index.js

@@ -781,7 +781,7 @@ var Y2 = ({ indicator: t = "dots" } = {}) => {
 
 // src/index.ts
 import { existsSync as existsSync2 } from "node:fs";
-import { delimiter, join as join2, relative as relative2, resolve as resolve2 } from "node:path";
+import { relative as relative2, resolve as resolve2 } from "node:path";
 
 // src/scaffold/index.ts
 import { signingIdentity } from "@astrale-os/adapter-cloudflare/build";
@@ -795,7 +795,7 @@ var HERE = dirname(fileURLToPath(import.meta.url));
 var CREATE_PACKAGE_ROOT = owningPackageRoot(HERE, "create-astrale-domain");
 var SDK_ROOT = sdkCheckoutRoot(CREATE_PACKAGE_ROOT);
 var ORIGIN_PLACEHOLDER = "astrale-domain.example.dev";
-var INSTANCE_PLACEHOLDER = "my-instance-slug";
+var INSTANCE_DECLARATION = "const targetInstance: string | undefined = undefined";
 var LINK_PACKAGES = /* @__PURE__ */ new Set([
   "@astrale-os/sdk",
   "@astrale-os/adapter-cloudflare",
@@ -1031,7 +1031,7 @@ async function materializeAdapter(opts) {
   await cp(join(templateDir(ADAPTER_PACKAGES[opts.adapter]), "astrale.config.ts"), config);
   await addAdapterDependency(opts.dir, ADAPTER_PACKAGES[opts.adapter]);
   if (opts.adapter === "astrale" && opts.instance) {
-    await replaceInFile(config, `'${INSTANCE_PLACEHOLDER}'`, `'${opts.instance}'`);
+    await replaceInFile(config, INSTANCE_DECLARATION, `const targetInstance = '${opts.instance}'`);
   }
 }
 async function addAdapterDependency(dir, adapter) {
@@ -1058,6 +1058,10 @@ var PREPACK_COMMANDS = {
 };
 async function materializePackageManagerInstructions(dir, packageManager) {
   const replacements = [
+    [
+      "pnpm dev --host <origin> --port <port>",
+      packageManagerScript(packageManager, "dev", "--host <origin> --port <port>")
+    ],
     ["pnpm run deploy prod", packageManagerScript(packageManager, "deploy", "prod")],
     ["pnpm deploy prod", packageManagerScript(packageManager, "deploy", "prod")],
     ["pnpm prod", packageManagerScript(packageManager, "deploy", "prod")],
@@ -1150,12 +1154,6 @@ function localPackageRoot(dependency) {
 
 // src/index.ts
 var PMS = ["pnpm", "npm", "yarn", "bun"];
-var DLX = {
-  pnpm: "pnpm dlx",
-  npm: "npx",
-  yarn: "yarn dlx",
-  bun: "bunx"
-};
 var ADAPTERS = [
   {
     value: "astrale",
@@ -1326,7 +1324,6 @@ async function main() {
       `cd ${cdTarget}`,
       `${pm} install`,
       devStep(pm),
-      installStep(pm),
       deployStep(pm, adapter, instance)
     ].join("\n"),
     "Next"
@@ -1342,26 +1339,12 @@ async function main() {
   Se(`\u2713 ${slug} ready`);
   return 0;
 }
-var devStep = (pm) => `${packageManagerScript(pm, "dev")}                          # wrangler dev \u2192 prints a local URL`;
+var devStep = (pm) => `${packageManagerScript(pm, "dev")}                          # complete development session`;
 var deployStep = (pm, adapter, instance) => {
   const hint = adapter === "astrale" ? `# managed deploy \u2192 installs on ${instance ? `"${instance}"` : "your instance"}` : "# deploy production \u2192 prints a URL";
   return `${deployCommand(pm)}                         ${hint}`;
 };
 var deployCommand = (pm) => packageManagerScript(pm, "deploy", "prod");
-function installStep(pm) {
-  if (astraleOnPath()) return "astrale domain install <url> --direct    # mount it on an instance";
-  return [
-    "# astrale CLI not found on PATH \u2014 run it on demand (no install):",
-    `${DLX[pm]} @astrale-os/cli domain install <url> --direct`,
-    "# or install it globally: npm i -g @astrale-os/cli"
-  ].join("\n");
-}
-function astraleOnPath() {
-  const path = process.env.PATH;
-  if (!path) return false;
-  const names = process.platform === "win32" ? ["astrale.cmd", "astrale.exe", "astrale.bat", "astrale"] : ["astrale"];
-  return path.split(delimiter).some((d3) => d3.length > 0 && names.some((n) => existsSync2(join2(d3, n))));
-}
 function detectPm() {
   const name = process.env.npm_config_user_agent?.split("/")[0];
   return PMS.find((p2) => p2 === name);
@@ -1408,7 +1391,7 @@ Arguments:
 Options:
   --adapter <id>      deployment adapter \u2014 astrale (managed, default) | cloudflare
   --frontend <id>     react (default) | custom | none
-  --instance <slug>   target instance for managed deploys (astrale adapter)
+  --instance <slug>   target instance for managed development and deploys
   --pm <pm>           pnpm | npm | yarn | bun   (default: detected, else pnpm)
   --dir <path>        target directory   (default: ./<slug>)
   --origin <fqdn>     domain identity origin   (default: <slug>.example.dev)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-astrale-domain",
-  "version": "0.3.0-beta.63",
+  "version": "0.3.0-beta.65",
   "description": "Scaffold a standalone Astrale domain — npm create astrale-domain",
   "keywords": [
     "astrale",
@@ -30,13 +30,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@astrale-os/adapter-astrale": "0.5.0-beta.63",
-    "@astrale-os/adapter-cloudflare": "0.5.0-beta.70",
+    "@astrale-os/adapter-astrale": "0.5.0-beta.65",
+    "@astrale-os/adapter-cloudflare": "0.5.0-beta.72",
     "@clack/prompts": "^0.11.0"
   },
   "devDependencies": {
     "@astrale-os/ox": "0.1.3",
-    "@astrale-os/sdk": "0.5.0-beta.67",
+    "@astrale-os/sdk": "0.5.0-beta.69",
     "@types/node": "^22.0.0",
     "esbuild": "^0.28.2",
     "oxfmt": "0.63.0",

package/template/.variants/custom/README.md

@@ -1,21 +1,23 @@
 # Astrale Domain
 
-This project uses the framework-neutral frontend escape hatch. `views/application/routes.ts` binds
-declared Views to `defineFrontend`; `vite.config.ts` owns the ordinary Vite root you can replace with any
-framework; `ui/` owns presentation assets. The starter route uses `handshake: 'none'`, so it mounts
-as a plain hosted app. Change that route to `handshake: 'shell'` only after your browser entrypoint
-boots the Shell protocol.
+This project uses the framework-neutral frontend escape hatch. `application.ts` binds declared
+Schema Views to `defineFrontend`; `vite.config.ts` owns the ordinary `frontend/` Vite root you can
+replace with any framework; `ui/` owns presentation assets. The starter route uses
+`handshake: 'none'`, so it mounts as a plain hosted app. Change that route to `handshake: 'shell'`
+only after your browser entrypoint boots the Shell protocol.
 
 ```text
 schema/             public Domain contract, including View declarations
 runtime.ts          Actions, Workflows, Integrations, Providers, and initialization
 application.ts      Schema, Runtime, and frontend composition
-views/              framework-neutral frontend declaration
-views/application/   application View, route, and browser entrypoint
+views/application/   application View projection and mount behavior
+frontend/            browser entrypoint and assets
 ui/application/      application presentation, tokens, and styles
 tests/               cross-layer executable journeys
 ```
 
-Run `pnpm dev` for local delivery and `pnpm build` to build both the Worker and browser assets.
+Run `pnpm dev` for Worker and browser hot reload. With the managed Astrale adapter, it also creates
+temporary public ingress, installs each ready revision on the selected (or active) instance, and
+opens its View. Run `pnpm build` to build both Worker and browser assets.
 Domain projects intentionally own no `.spec` trees and import authoring contracts only through
 semantic `@astrale-os/sdk/*` subpaths.

package/template/.variants/custom/application.ts

@@ -1,9 +1,17 @@
-import { defineApplication } from '@astrale-os/sdk/application'
+import { defineApplication, defineFrontend, vite } from '@astrale-os/sdk/application'
 
 import { schema } from '#schema'
-import { frontend } from '#views'
 
 import runtime from './runtime.js'
 
+/** Framework-neutral escape hatch: swap Vite or the browser implementation without changing Views. */
+const frontend = defineFrontend({
+  schema,
+  source: vite(),
+  routes: {
+    application: { handshake: 'none' },
+  },
+})
+
 /** Build and publication composition; provider effects live in astrale.config.ts. */
 export const application = defineApplication({ schema, runtime, frontend })

package/template/.variants/custom/{views/application/app → frontend}/main.ts

@@ -1,3 +1,3 @@
-import { mountApplication } from '../application.view.js'
+import { mountApplication } from '#views/application'
 
 mountApplication(document.querySelector<HTMLElement>('#application'))

package/template/.variants/custom/frontend/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "astrale-frontend",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2"
+  }
+}

package/template/.variants/custom/frontend/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "paths": {
+      "#views/*": ["../views/*/index.ts"]
+    },
+    "strict": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "skipLibCheck": false,
+    "verbatimModuleSyntax": true
+  },
+  "include": ["main.ts"]
+}

package/template/.variants/custom/views/application/index.ts

@@ -0,0 +1 @@
+export { mountApplication } from './application.view.js'

package/template/.variants/custom/views/index.ts

@@ -1 +1 @@
-export { frontend } from './application/routes.js'
+export { mountApplication } from './application/index.js'

package/template/.variants/custom/vite.config.ts

@@ -1,9 +1,18 @@
+import { fileURLToPath } from 'node:url'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
-  root: 'views/application/app',
+  root: 'frontend',
+  resolve: {
+    alias: [
+      {
+        find: /^#views\//,
+        replacement: fileURLToPath(new URL('./views/', import.meta.url)),
+      },
+    ],
+  },
   build: {
-    outDir: '../../../dist/frontend',
+    outDir: '../dist/frontend',
     emptyOutDir: true,
   },
 })

package/template/.variants/none/README.md

@@ -9,6 +9,8 @@ application.ts      Schema and Runtime composition
 tests/               cross-layer executable journeys
 ```
 
-Run `pnpm dev` for a local Worker and `pnpm build` to qualify its deploy bundle. Add `views/` and
+Run `pnpm dev` for Worker hot reload. With the managed Astrale adapter, it also creates temporary
+public ingress and installs each ready revision on the selected (or active) instance; it simply
+skips browser startup because this Domain declares no frontend. Run `pnpm build` to qualify its deploy bundle. Add `views/` and
 `ui/` later only when the schema gains declared Views. Domain projects intentionally own no `.spec`
 trees and import authoring contracts only through semantic `@astrale-os/sdk/*` subpaths.

package/template/.variants/react/README.md

@@ -1,22 +1,24 @@
 # Astrale Domain
 
-This project is an ordinary Vite React application. `views/routes.ts` is the small Worker-safe
-delivery artifact; `frontend/` owns TanStack Router and browser composition; `ui/` owns reusable
-presentation. It has no mandatory Shell runtime: add `@astrale-os/shell-react` independently when
-the application genuinely needs Shell sessions, graph context, or View-stage integration.
+This project is an ordinary Vite React application. `application.ts` owns the small Worker-safe,
+Schema-bound frontend deployment contract; `frontend/` owns TanStack Router and browser
+composition; `ui/` owns reusable presentation. It has no mandatory Shell runtime: add
+`@astrale-os/shell-react` independently when the application genuinely needs Shell sessions, graph
+context, or View-stage integration.
 
 ```text
 schema/             public Domain contract, including View declarations
 runtime.ts          Actions, Workflows, Integrations, Providers, and initialization
 application.ts      Schema, Runtime, and frontend composition
-views/              schema-bound frontend declaration
 frontend/            Vite, file-based TanStack Router, and Tailwind entrypoint
 ui/                  styles and pure presentation components
 tests/               cross-layer executable journeys
 ```
 
-Run `pnpm dev` for one Worker-facing URL with Vite HMR, `pnpm build` to qualify Worker and frontend output,
-and `pnpm run deploy prod` to deploy through the selected adapter. Add semantic `rules/`, `queries/`,
+Run `pnpm dev` for one Worker-facing URL with Vite HMR. With the managed Astrale adapter, that same
+command also creates a temporary public ingress, installs each ready revision on the selected (or
+active) instance, and opens its View. Run `pnpm build` to qualify Worker and frontend output, and
+`pnpm run deploy prod` to deploy through the selected adapter. Add semantic `rules/`, `queries/`,
 `mutations/`, and `actions/` modules only when the Domain gains those responsibilities.
 
 Domain projects intentionally own no `.spec` trees. Import authoring contracts through semantic

package/template/.variants/react/application.ts

@@ -1,9 +1,17 @@
-import { defineApplication } from '@astrale-os/sdk/application'
+import { defineApplication, defineFrontend, vite } from '@astrale-os/sdk/application'
 
 import { schema } from '#schema'
-import { frontend } from '#views'
 
 import runtime from './runtime.js'
 
+/** The complete deploy contract; Vite and the browser application stay author-owned. */
+const frontend = defineFrontend({
+  schema,
+  source: vite(),
+  routes: {
+    application: { handshake: 'none' },
+  },
+})
+
 /** Build and publication composition; provider effects live in astrale.config.ts. */
 export const application = defineApplication({ schema, runtime, frontend })

package/template/CLAUDE.md

@@ -27,6 +27,12 @@ Schema contract at the package root. Runtime, handlers, Providers, frontend code
 adapters remain implementation inputs and are not published. Do not add a parallel build or
 declaration-rewrite script.
 
+`pnpm dev` owns the complete development session. With the managed Astrale adapter it acquires
+private ingress, starts Worker and optional Vite hot reload, reconciles the Domain installation on
+the configured or active instance, and opens the View when one exists. Stop closes only local
+processes; it retains the installation and local reconciliation evidence for the next run. Do not
+add a parallel tunnel, install loop, frontend watcher, or automatic shutdown uninstall.
+
 Domain projects do not contain `.spec` directories. Do not add one: public SDK types, package
 facades, the Domain knowledge rules, and executable tests are the contract guardrails. Import Core
 and DSL authoring values only from the matching `@astrale-os/sdk/*` semantic subpath; never import

package/template/.variants/custom/views/application/__tests__/routes.test.ts

@@ -1,7 +0,0 @@
-import { frontend } from '../routes.js'
-
-describe('application View routes', () => {
-  it('owns the generated application entrypoint', () => {
-    expect(frontend.entrypoint).toBe('application')
-  })
-})

package/template/.variants/custom/views/application/routes.ts

@@ -1,12 +0,0 @@
-import { defineFrontend, vite } from '@astrale-os/sdk/view'
-
-import { schema } from '#schema'
-
-/** Framework-neutral escape hatch: swap Vite or the browser implementation without changing Views. */
-export const frontend = defineFrontend({
-  schema,
-  source: vite(),
-  routes: {
-    application: { handshake: 'none' },
-  },
-})

package/template/.variants/react/views/application/__tests__/routes.test.ts

@@ -1,7 +0,0 @@
-import { frontend } from '../routes.js'
-
-describe('application View routes', () => {
-  it('owns the generated application entrypoint', () => {
-    expect(frontend.entrypoint).toBe('application')
-  })
-})

package/template/.variants/react/views/application/routes.ts

@@ -1,12 +0,0 @@
-import { defineFrontend, vite } from '@astrale-os/sdk/view'
-
-import { schema } from '#schema'
-
-/** The complete deploy contract; Vite and the browser application stay author-owned. */
-export const frontend = defineFrontend({
-  schema,
-  source: vite(),
-  routes: {
-    application: { handshake: 'none' },
-  },
-})

package/template/.variants/react/views/index.ts

@@ -1 +0,0 @@
-export { frontend } from './application/routes.js'