feat: unify phase one creation flow

scripts/dev.test.ts

@@ -9,12 +9,14 @@ import {
   assertReusableSpacetimeProcessVersionMatchesWorkspace,
   assertSpacetimeToolVersionMatchesWorkspace,
   buildApiServerProcessEnv,
+  buildDevStackSnapshot,
   buildSpacetimePublishArgs,
   createDevServerSpawnOptions,
   createWatchConfigs,
   isSpacetimePublishPermissionError,
   parseSpacetimeToolVersion,
   parseArgs,
+  resolveDevStackStatePath,
   shouldAcceptWatchEvent,
 } from './dev.mjs';
 
@@ -105,6 +107,79 @@ describe('dev scheduler api-server env', () => {
   });
 });
 
+describe('dev scheduler stack state file', () => {
+  test('状态文件路径固定在根目录 .app/dev-stack.json', () => {
+    expect(resolveDevStackStatePath('C:\\repo\\Genarrative')).toBe(
+      join('C:\\repo\\Genarrative', '.app/dev-stack.json'),
+    );
+  });
+
+  test('状态快照记录服务 pid、端口、URL 和当前命令', () => {
+    const updatedAt = '2026-05-29T00:00:00.000Z';
+    const runner = {
+      command: 'web',
+      options: {
+        apiHost: '127.0.0.1',
+        apiPort: 8090,
+        webHost: '0.0.0.0',
+        webPort: 3010,
+        adminWebHost: '127.0.0.1',
+        adminWebPort: 3110,
+        spacetimeHost: '127.0.0.1',
+        spacetimePort: 3120,
+        spacetimeDataDir: 'server-rs/.spacetimedb/local/data',
+        database: 'genarrative-test',
+        watch: false,
+      },
+      state: {
+        apiTarget: 'http://127.0.0.1:8090',
+        adminWebTargetHost: '127.0.0.1',
+        spacetimeServer: 'http://127.0.0.1:3120',
+      },
+      services: new Map([
+        [
+          'web',
+          {
+            child: {pid: 4321},
+            runtime: {
+              status: 'running',
+              pid: 4321,
+              host: '0.0.0.0',
+              port: 3010,
+              url: 'http://127.0.0.1:3010',
+              command: 'node scripts/vite-cli.mjs --port=3010',
+              startedAt: updatedAt,
+              updatedAt,
+              exitCode: null,
+              signal: null,
+            },
+          },
+        ],
+      ]),
+    };
+
+    const snapshot = buildDevStackSnapshot(runner, updatedAt);
+
+    expect(snapshot.schemaVersion).toBe(1);
+    expect(snapshot.command).toBe('web');
+    expect(snapshot.database).toBe('genarrative-test');
+    expect(snapshot.services.web).toMatchObject({
+      status: 'running',
+      pid: 4321,
+      host: '0.0.0.0',
+      port: 3010,
+      url: 'http://127.0.0.1:3010',
+      command: 'node scripts/vite-cli.mjs --port=3010',
+    });
+    expect(snapshot.services['api-server']).toMatchObject({
+      status: 'idle',
+      pid: null,
+      port: 8090,
+      url: 'http://127.0.0.1:8090',
+    });
+  });
+});
+
 describe('dev scheduler spacetime reuse guard', () => {
   test('记录 URL 可 ping 但没有 spacetime.pid 时不复用宿主', async () => {
     const tempDir = mkdtempSync(join(tmpdir(), 'genarrative-spacetime-reuse-'));