FE-1532: Track a launch config for the Petrinaut dev servers

.claude/launch.json

@@ -0,0 +1,33 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "@hashintel/petrinaut (storybook)",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": ["workspace", "@hashintel/petrinaut", "dev"],
+      "port": 6006,
+      "autoPort": true
+    },
+    {
+      "name": "@apps/petrinaut-website",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": ["workspace", "@apps/petrinaut-website", "dev"],
+      "port": 5173,
+      "autoPort": true
+    },
+    {
+      "name": "@apps/petrinaut-docs",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": [
+        "exec",
+        "turbo",
+        "run",
+        "dev",
+        "--filter",
+        "@apps/petrinaut-docs"
+      ],
+      "port": 4321,
+      "autoPort": true
+    }
+  ]
+}

apps/petrinaut-docs/package.json

@@ -7,7 +7,7 @@
   "type": "module",
   "scripts": {
     "build": "astro build",
-    "dev": "astro dev",
+    "dev": "astro dev --port ${PORT:-4321}",
     "lint:tsc": "astro check --minimumSeverity error",
     "preview": "astro preview",
     "sync:bundle": "node scripts/sync-bundle.mjs"

apps/petrinaut-docs/turbo.json

@@ -24,7 +24,9 @@
     "dev": {
       "cache": false,
       "persistent": true,
-      "dependsOn": ["sync:bundle"]
+      "dependsOn": ["sync:bundle"],
+      // The Claude Code preview passes the port to serve on.
+      "env": ["PORT"]
     }
   }
 }

apps/petrinaut-website/vite.config.ts

@@ -84,6 +84,8 @@ export default defineConfig(({ mode }) => {
       port: process.env.PORT ? Number(process.env.PORT) : 4173,
     },
     server: {
+      /** the Claude Code preview may provide a PORT to run on */
+      port: process.env.PORT ? Number(process.env.PORT) : 5173,
       proxy: {
         "/api/petrinaut-opt": {
           target: process.env.PETRINAUT_OPT_ORIGIN ?? "http://127.0.0.1:4004",

libs/@hashintel/petrinaut/scripts/dev.sh

@@ -9,4 +9,4 @@ set -euo pipefail
 cd "$(dirname "$0")/.."
 . ../../@local/petrinaut-optimizer-client/scripts/optimizer-service.sh
 optimizer_service_parse "$@"
-run_dev_server yarn storybook dev ${OPTIMIZER_FORWARDED[@]+"${OPTIMIZER_FORWARDED[@]}"}
+run_dev_server yarn storybook dev -p "${PORT:-6006}" ${OPTIMIZER_FORWARDED[@]+"${OPTIMIZER_FORWARDED[@]}"}