修复 dev:all 端口段与前端就绪判定

将 CLI port-range 同步到 AGC 端口解析环境。

将主站和后台 HTTP readiness 限制为 2xx。

补充真实 HTTP 状态码与端口段传递测试。

scripts/dev-all.test.ts

@@ -1,4 +1,6 @@
 import { EventEmitter } from 'node:events';
+import { createServer } from 'node:http';
+import type { AddressInfo } from 'node:net';
 import { resolve } from 'node:path';
 
 import { describe, expect, test } from 'vitest';
@@ -6,10 +8,12 @@ import { describe, expect, test } from 'vitest';
 import {
   agcDatabase,
   agcDataDir,
+  buildDevAllBaseEnvironment,
   buildDevAllEnvironment,
   buildManagedSpawnOptions,
   buildRootDevArgs,
   buildStartupSummary,
+  isHttpReady,
   isSharedRootStackReady,
   renderStartupTable,
   runDevAll,
@@ -86,6 +90,48 @@ describe('dev:all 参数和共享开发栈合同', () => {
     expect(baseEnv.AGC_DEV_ADMIN_WEB).toBe('1');
   });
 
+  test('CLI port-range 覆盖旧环境并同步给 AGC', () => {
+    const env = buildDevAllBaseEnvironment(['--port-range', '10100-10199'], {
+      GENARRATIVE_DEV_PORT_RANGE: '10000-10099',
+    });
+
+    expect(env.GENARRATIVE_DEV_PORT_RANGE).toBe('10100-10199');
+  });
+
+  test.each([
+    [200, true],
+    [204, true],
+    [299, true],
+    [400, false],
+    [401, false],
+    [403, false],
+    [404, false],
+    [500, false],
+    [503, false],
+  ])('HTTP %i 的前端就绪结果为 %s', async (status, expected) => {
+    const server = createServer((_request, response) => {
+      response.writeHead(status).end();
+    });
+    await new Promise<void>((resolveListen) => {
+      server.listen(0, '127.0.0.1', resolveListen);
+    });
+
+    try {
+      const { port } = server.address() as AddressInfo;
+      await expect(isHttpReady(`http://127.0.0.1:${port}`)).resolves.toBe(
+        expected,
+      );
+    } finally {
+      server.closeAllConnections();
+      await new Promise<void>((resolveClose, rejectClose) => {
+        server.close((error) => {
+          if (error) rejectClose(error);
+          else resolveClose();
+        });
+      });
+    }
+  });
+
   test('Windows 下通过 shell 启动 npm.cmd', () => {
     const options = buildManagedSpawnOptions(process.env);