fix: isolate dev stack runtime state

Author: pallyoung

scripts/test/dev-stack-runtime.mjs

@@ -0,0 +1,21 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+export function buildDevStackRuntimeEnv(root, env = process.env) {
+  const stateDir = env.CODER_STUDIO_HOME
+    ? path.resolve(env.CODER_STUDIO_HOME)
+    : path.join(root, '.tmp', 'dev-stack-runtime');
+
+  return {
+    stateDir,
+    env: {
+      ...env,
+      CODER_STUDIO_HOME: stateDir,
+    },
+  };
+}
+
+export async function resetDevStackRuntimeState(stateDir) {
+  await fs.rm(stateDir, { recursive: true, force: true });
+  await fs.mkdir(stateDir, { recursive: true });
+}

scripts/test/start-dev-stack.mjs

@@ -1,10 +1,13 @@
+import fs from 'node:fs/promises';
 import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
+import { buildDevStackRuntimeEnv, resetDevStackRuntimeState } from './dev-stack-runtime.mjs';
 
 const ROOT = fileURLToPath(new URL('../..', import.meta.url));
 const PNPM_CMD = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
 let frontend = null;
+const runtime = buildDevStackRuntimeEnv(ROOT, process.env);
 
 let shuttingDown = false;
 
@@ -34,10 +37,14 @@ function spawnPnpm(args) {
   return spawn(resolved.command, resolved.args, {
     cwd: ROOT,
     stdio: 'inherit',
-    windowsHide: true
+    windowsHide: true,
+    env: runtime.env,
   });
 }
 
+await fs.mkdir(path.join(ROOT, '.tmp'), { recursive: true });
+await resetDevStackRuntimeState(runtime.stateDir);
+
 const server = spawnPnpm(['dev:server']);
 
 const killChild = (child) => {

tests/release/release.test.mjs

@@ -11,6 +11,10 @@ import {
 import { assertReleaseAssets } from '../../scripts/release/check-assets.mjs';
 import { assertVersionConsistency, collectReleaseVersionState } from '../../scripts/release/check-version.mjs';
 import { createReleaseManifest } from '../../scripts/release/write-release-manifest.mjs';
+import {
+  buildDevStackRuntimeEnv,
+  resetDevStackRuntimeState,
+} from '../../scripts/test/dev-stack-runtime.mjs';
 
 test('release assets required for packaging are present', async () => {
   await assertReleaseAssets();
@@ -76,3 +80,28 @@ test('release manifest writer emits checksums for tarballs', async () => {
     await fs.rm(tempRoot, { recursive: true, force: true });
   }
 });
+
+test('dev stack runtime defaults to an isolated repo-local state dir', () => {
+  const root = '/tmp/coder-studio-root';
+  const result = buildDevStackRuntimeEnv(root, {});
+
+  assert.equal(result.stateDir, path.join(root, '.tmp', 'dev-stack-runtime'));
+  assert.equal(result.env.CODER_STUDIO_HOME, path.join(root, '.tmp', 'dev-stack-runtime'));
+});
+
+test('dev stack runtime reset clears prior state contents', async () => {
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'coder-studio-dev-stack-'));
+  const stateDir = path.join(tempRoot, 'state');
+
+  try {
+    await fs.mkdir(path.join(stateDir, 'nested'), { recursive: true });
+    await fs.writeFile(path.join(stateDir, 'nested', 'stale.txt'), 'stale', 'utf8');
+
+    await resetDevStackRuntimeState(stateDir);
+
+    const entries = await fs.readdir(stateDir);
+    assert.deepEqual(entries, []);
+  } finally {
+    await fs.rm(tempRoot, { recursive: true, force: true });
+  }
+});