create-substrat 0.10.11 → 0.10.13

package/dev-servers.js

@@ -24,8 +24,8 @@
  */
 
 /**
- * Two processes: the local OIDC issuer, and the Hono API that relies on it. There is no
- * web app to scaffold yet.
+ * Three processes: the local OIDC issuer, the Hono API that relies on it, and the test
+ * dashboard. There is no web app to scaffold yet.
  *
  * The issuer is a separate PROCESS rather than a branch inside the API on purpose — that
  * is what keeps the vertical free of any dev-only auth path, and lets it be swapped for a
@@ -34,4 +34,7 @@
 export const DEV_SERVERS = [
   { name: 'issuer', run: 'issuer', portEnv: 'ISSUER_PORT', portFrom: 'src/server.ts' },
   { name: 'api', run: 'server', portEnv: 'PORT', portFrom: 'src/server.ts' },
+  // The test dashboard (#756). 5290 — clear of the demo blocks (527x/528x/529x), which a
+  // scaffold has no claim on (#983).
+  { name: 'tests', run: 'test:ui', portEnv: 'VITEST_UI_PORT', portFrom: 'vitest.ui.config.ts' },
 ];

package/index.js

@@ -36,11 +36,12 @@ const TEMPLATE = join(HERE, 'template');
 // The runtime packages release together off one version line (the changesets `fixed`
 // group), so one constant is right for all of them. Engines do NOT share a line —
 // each versions on its own, so one pin per engine, deliberately.
-const SUBSTRAT = '^0.134.0';
-const ENGINE_WORKORDER = '^0.12.18';
-const ENGINE_INVOICING = '^0.11.18';
+const SUBSTRAT = '^0.136.0';
+const ENGINE_WORKORDER = '^0.12.20';
+const ENGINE_INVOICING = '^0.11.20';
 const BOUNDARY_LINT = '^0.6.1';
-const DEV_ISSUER = '^0.2.16';
+const DEV_ISSUER = '^0.2.18';
+const ATTACHMENT_EXTRACTORS = '^0.1.2';
 
 const DOCS = 'https://substrat.net';
 
@@ -113,6 +114,9 @@ function packageJson(name) {
         issuer: 'substrat-dev-issuer --personas src/personas.ts',
         server: 'tsx src/server.ts',
         test: 'vitest run',
+        // The live test dashboard in the Browser pane: the `tests` entry of
+        // .claude/launch.json. `--watch` is explicit, since vitest runs once and exits without a TTY.
+        'test:ui': 'vitest --watch --ui --open=false -c vitest.ui.config.ts',
         typecheck: 'tsc --noEmit && tsc -p tsconfig.worker.json --noEmit',
         'lint:boundaries': 'substrat-boundary-lint',
       },
@@ -122,6 +126,7 @@ function packageJson(name) {
         '@substrat-run/adapter-sqlite': SUBSTRAT,
         '@substrat-run/adapter-cloudflare': SUBSTRAT,
         '@substrat-run/vertical-host': SUBSTRAT,
+        '@substrat-run/attachment-extractors': ATTACHMENT_EXTRACTORS,
         '@substrat-run/engine-workorder': ENGINE_WORKORDER,
         '@substrat-run/engine-invoicing': ENGINE_INVOICING,
         hono: '^4.6.0',
@@ -140,6 +145,7 @@ function packageJson(name) {
         tsx: '^4.19.0',
         typescript: '^5.6.0',
         vitest: '^3.0.0',
+        '@vitest/ui': '^3.0.0',
       },
       // Do NOT add `zod` here — import `z` from `@substrat-run/contracts` (AGENTS.md, rule 10).
       // better-sqlite3 >=13 ships prebuilt binaries for every supported platform and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-substrat",
-  "version": "0.10.11",
+  "version": "0.10.13",
   "description": "Scaffold a Substrat vertical — `npm create substrat <dir>`.",
   "license": "Apache-2.0",
   "repository": {
@@ -33,5 +33,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "scripts": {}
 }

package/template/.claude/launch.json

@@ -20,6 +20,16 @@
       ],
       "port": 8891,
       "autoPort": false
+    },
+    {
+      "name": "tests",
+      "runtimeExecutable": "pnpm",
+      "runtimeArgs": [
+        "run",
+        "test:ui"
+      ],
+      "port": 5290,
+      "autoPort": false
     }
   ]
 }

package/template/src/seed.ts

@@ -11,6 +11,7 @@ import {
 } from '@substrat-run/contracts';
 import { ulid } from '@substrat-run/kernel';
 import { SqliteScopeHost } from '@substrat-run/adapter-sqlite';
+import { defaultAttachmentExtractors } from '@substrat-run/attachment-extractors';
 import { ENTITLEMENT_KEYS, MODULES, OWNER_ROLE_KEY, portalPerms, ROLES } from './provision.js';
 
 // The provisioning surface (modules, roles, grant shapes) lives in
@@ -43,7 +44,7 @@ export interface BikeShopWorld {
 }
 
 export function buildBikeShopHost(dir: string): SqliteScopeHost {
-  const host = new SqliteScopeHost({ dir });
+  const host = new SqliteScopeHost({ dir, attachmentExtractors: defaultAttachmentExtractors() });
   for (const m of MODULES) host.registerModule(m);
   return host;
 }

package/template/src/worker.ts

@@ -47,14 +47,15 @@ import {
   SCOPE_SWEEPER_NAME,
   type ScopeSweeperDo,
 } from '@substrat-run/adapter-cloudflare';
+import type { ScopeStub } from '@substrat-run/kernel';
+import { defaultAttachmentExtractors } from '@substrat-run/attachment-extractors';
 import {
   kickFlags,
+  mountPlatformSurface,
   readRoutedNode,
   RouterAssertionError,
-  type ScopeStub,
   invocationLog,
-} from '@substrat-run/kernel';
-import { mountPlatformSurface } from '@substrat-run/vertical-host';
+} from '@substrat-run/vertical-host';
 import { MODULES, OWNER_ROLE_KEY, ROLES } from './provision.js';
 import { SHOP_ENV } from './manifest.js';
 import { mountApi } from './routes.js';
@@ -146,7 +147,7 @@ function nodeFor(req: Request, env: Env): Node {
 }
 
 function hostFor(env: Env): CloudflareScopeHost {
-  const host = new CloudflareScopeHost({ scope: env.SCOPE });
+  const host = new CloudflareScopeHost({ scope: env.SCOPE, attachmentExtractors: defaultAttachmentExtractors() });
   for (const m of MODULES) host.registerModule(m);
   return host;
 }

package/template/vitest.ui.config.ts

@@ -0,0 +1,37 @@
+/**
+ * The config behind `pnpm test:ui` — your own `vitest.config.ts`, plus the live test
+ * dashboard served on a port Claude Desktop's Browser pane can open (`.claude/launch.json`,
+ * the `tests` entry).
+ *
+ * The UI lives at `/__vitest__/` and the bare origin is a 404, but a launch entry carries
+ * a port and never a path, so `/` is redirected to the UI here. `VITEST_UI_PORT` moves
+ * the port; it binds 127.0.0.1 only, since the dashboard can re-run your tests. The port
+ * is strict: a busy one fails the start rather than moving the dashboard somewhere the
+ * launch entry does not point.
+ */
+import { mergeConfig, type Plugin } from 'vitest/config';
+
+import base from './vitest.config.ts';
+
+const redirectRootToUi: Plugin = {
+  name: 'substrat:vitest-ui-root',
+  configureServer(server) {
+    server.middlewares.use((req, res, next) => {
+      if (req.url !== '/') return next();
+      res.statusCode = 302;
+      res.setHeader('Location', '/__vitest__/');
+      res.end();
+    });
+  },
+};
+
+export default mergeConfig(base, {
+  plugins: [redirectRootToUi],
+  test: {
+    api: {
+      host: '127.0.0.1',
+      port: Number(process.env.VITEST_UI_PORT ?? 5290),
+      strictPort: true,
+    },
+  },
+});