create-substrat 0.10.10 → 0.10.12

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,11 @@ 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.133.0';
-const ENGINE_WORKORDER = '^0.12.17';
-const ENGINE_INVOICING = '^0.11.17';
+const SUBSTRAT = '^0.135.0';
+const ENGINE_WORKORDER = '^0.12.19';
+const ENGINE_INVOICING = '^0.11.19';
 const BOUNDARY_LINT = '^0.6.1';
-const DEV_ISSUER = '^0.2.15';
+const DEV_ISSUER = '^0.2.17';
 
 const DOCS = 'https://substrat.net';
 
@@ -113,6 +113,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',
       },
@@ -140,6 +143,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.10",
+  "version": "0.10.12",
   "description": "Scaffold a Substrat vertical — `npm create substrat <dir>`.",
   "license": "Apache-2.0",
   "repository": {

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/.substrat/playbook.md

@@ -289,8 +289,10 @@ export const model = emitModel(entities);
 
 These are compile errors, not lints: a `parents` naming no entity, a `permission` that is
 not declared, an `entityIdFrom` naming no field of that operation's `output`, a `payload`
-carrying a field the entity marks `erasable`, a `{var}` in an HTTP path that names no input
-field. All before a handler exists.
+carrying a field the entity marks `erasable` or `outsideText`, a `{var}` in an HTTP path that
+names no input field. All before a handler exists. Mark `outsideText` on any column whose value
+a customer, a remote system or an inbound header writes and that is not personal data (an error
+a provider returned, a subject line, a fetched document): it may sit on its row, never on an event.
 
 Field names mirror the SQL columns, snake_case included — a prettier naming here is a second
 description of the same rows. Not every table is an entity: an entity is something the

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,
+    },
+  },
+});