@ihyeon/flow-qa 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.ko.md

@@ -11,10 +11,10 @@
 
 ## 로컬 데모 시작
 
-Node.js 24 이상이 필요합니다. 패키지는 `@ihyeon/flow-qa@0.1.0-alpha.2`입니다. 브라우저는 첫 실행 전에 설치합니다.
+Node.js 24 이상이 필요합니다. 패키지는 `@ihyeon/flow-qa@0.1.0-alpha.3`입니다. 브라우저는 첫 실행 전에 설치합니다.
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.1.0-alpha.2
+npm install -g @ihyeon/flow-qa@0.1.0-alpha.3
 flow-qa browser install
 flow-qa ui --demo
 ```

package/README.md

@@ -14,7 +14,7 @@ Flow QA turns a user flow into reviewable test cases, runs them in a real browse
 Requires Node.js 24 or later. Install Chromium before the first run:
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.1.0-alpha.2
+npm install -g @ihyeon/flow-qa@0.1.0-alpha.3
 flow-qa browser install
 flow-qa ui --demo
 ```

package/dist/src/report.js

@@ -166,11 +166,18 @@ export function normalizeReport1(raw, context) {
         const attempts = array(result.attempts, 'result.attempts').map((attempt) => normalizeAttempt(attempt, context.rawDir));
         if (status !== 'skipped' && attempts.length === 0)
             throw new Error(`Test result has no attempts: ${id}`);
-        if (status === 'passed' && attempts.at(-1)?.status !== 'passed')
+        const finalAttemptStatus = attempts.at(-1)?.status;
+        if (status === 'passed' && (attempts.length !== 1 || attempts[0]?.index !== 0 || finalAttemptStatus !== 'passed')) {
             throw new Error(`Passed status and attempts disagree: ${id}`);
-        if (status === 'flaky' && (attempts.at(-1)?.status !== 'passed' || !attempts.slice(0, -1).some((attempt) => attempt.status !== 'passed'))) {
+        }
+        if (status === 'flaky' && (attempts.length < 2 || finalAttemptStatus !== 'passed'
+            || attempts.some((attempt, index) => attempt.index !== index
+                || (index < attempts.length - 1 && attempt.status !== 'failed' && attempt.status !== 'timed-out')))) {
             throw new Error(`Flaky status and attempts disagree: ${id}`);
         }
+        if ((status === 'failed' || status === 'timed-out') && finalAttemptStatus === 'passed') {
+            throw new Error(`Failed or timed-out status and attempts disagree: ${id}`);
+        }
         if (context.blockedReasons.has(id) && status !== 'skipped')
             throw new Error(`A blocked case was recorded as executed: ${id}`);
         const skip = result.skip === undefined ? undefined : object(result.skip, 'result.skip');

package/dist/src/ui/server.js

@@ -753,6 +753,8 @@ export async function startUIServer(options) {
             closing = true;
             controller?.abort();
             closeTask = (async () => {
+                const stopped = new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve()));
+                server.closeIdleConnections();
                 if (requestTasks.size) {
                     let requestTimeout;
                     try {
@@ -765,8 +767,7 @@ export async function startUIServer(options) {
                         clearTimeout(requestTimeout);
                     }
                 }
-                const stopped = new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve()));
-                server.closeIdleConnections();
+                server.closeAllConnections();
                 await stopped;
                 const pending = runTask;
                 if (pending) {

package/docs/releases.md

@@ -1,9 +1,40 @@
 # Alpha release and verification
 
+## 0.1.0-alpha.3
+
+This maintenance release keeps the existing CLI, UI, and case schema. It tightens result validation, bounds UI shutdown, and checks the command that npm installs for consumers.
+
+- A result marked `passed` must contain a single first attempt that passed. A passing retry must have a consistent `flaky` history. Contradictory histories are rejected instead of producing a misleading success report.
+- UI shutdown stops accepting connections immediately, allows existing requests up to one second to finish, and then closes remaining HTTP connections. An incomplete JSON request can no longer hold shutdown open. Planner cancellation responses and run cancellation are preserved.
+- Consumer smoke checks verify npm's installed `flow-qa` command and invoke it offline for help, workspace initialization, validation, and runtime diagnostics. The installed UI still runs three real Chromium cases.
+
+Both runtime fixes have regression tests that failed before the changes and passed afterward. Verification uses local test data and no model calls; it does not establish external authentication or model quality.
+
+Checked on macOS with Node.js 24.14.1 on 2026-10-12: all 47 tests, type checking, UI syntax, and the design-system audit passed. Real Chromium checks preserved normal pass, intentional assertion failure, and unreachable-app classifications. The bilingual UI smoke passed, including report downloads and a 390px viewport. The runtime dependency audit reported zero known vulnerabilities at that time.
+
+- Package: [`@ihyeon/flow-qa@0.1.0-alpha.3`](https://www.npmjs.com/package/@ihyeon/flow-qa/v/0.1.0-alpha.3)
+- Source and package: [GitHub alpha release](https://github.com/hyeonse-swing/flow-qa/releases/tag/v0.1.0-alpha.3)
+- Public checks: [GitHub Actions](https://github.com/hyeonse-swing/flow-qa/actions/workflows/ci.yml)
+
+To reproduce this release's checks from its source:
+
+```sh
+npm ci
+npm run check
+npm run qa -- browser install
+npm run demo:smoke
+npm run smoke:ui
+npm run check:package
+npm run smoke:package
+FLOWQA_PACKAGE_SPEC=@ihyeon/flow-qa@0.1.0-alpha.3 npm run smoke:package
+```
+
 ## 0.1.0-alpha.2
 
 This update replaces the introductory video link with two UI screenshots. Runtime behavior is unchanged from alpha.1. Media files are not included in the npm tarball.
 
+The verification record and reproduction commands below describe alpha.2. Use its matching source tag when reproducing that historical release.
+
 This public alpha provides a local CLI and UI, structured case validation, browser-run orchestration, and QA reports linked to evidence. Its bundled to-do app demo runs without a model.
 
 - Package: [`@ihyeon/flow-qa@0.1.0-alpha.2`](https://www.npmjs.com/package/@ihyeon/flow-qa/v/0.1.0-alpha.2), with the `alpha` dist-tag

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihyeon/flow-qa",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "license": "MIT",
   "author": "Hyeonse Im",
   "repository": {