p-dev-harness 0.3.0

package/dist/gui/dev-server-process.js

@@ -0,0 +1,165 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export const STABLE_GUI_HOST = "localhost";
+export const STABLE_GUI_PORT = 3000;
+export const STABLE_GUI_FALLBACK_PORTS = [3001];
+export function looksLikeGuiDevServer(command) {
+    const normalized = command.toLowerCase();
+    return (normalized.includes("next dev") ||
+        (normalized.includes("next") && normalized.includes("dev")) ||
+        (normalized.includes("apps/gui") && normalized.includes("next")));
+}
+export async function listPortListeners(port) {
+    if (process.platform === "win32") {
+        return [];
+    }
+    try {
+        const { stdout } = await execFileAsync("lsof", [
+            "-nP",
+            `-iTCP:${port}`,
+            "-sTCP:LISTEN",
+            "-F",
+            "pcn",
+        ]);
+        return parseLsofOutput(stdout, port);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes("lsof")) {
+            return [];
+        }
+        throw error;
+    }
+}
+function parseLsofOutput(stdout, port) {
+    const entries = [];
+    let currentPid;
+    let currentCommand = "";
+    for (const line of stdout.split("\n")) {
+        if (!line) {
+            if (currentPid !== undefined) {
+                entries.push({
+                    pid: currentPid,
+                    port,
+                    command: currentCommand.trim(),
+                });
+                currentPid = undefined;
+                currentCommand = "";
+            }
+            continue;
+        }
+        const tag = line[0];
+        const value = line.slice(1);
+        if (tag === "p") {
+            currentPid = Number.parseInt(value, 10);
+        }
+        else if (tag === "c") {
+            currentCommand = value;
+        }
+    }
+    if (currentPid !== undefined) {
+        entries.push({
+            pid: currentPid,
+            port,
+            command: currentCommand.trim(),
+        });
+    }
+    return entries.filter((entry) => Number.isFinite(entry.pid));
+}
+export async function readProcessCommand(pid) {
+    if (process.platform === "win32") {
+        return "";
+    }
+    try {
+        const { stdout } = await execFileAsync("ps", ["-p", String(pid), "-o", "args="]);
+        return stdout.trim();
+    }
+    catch {
+        return "";
+    }
+}
+export async function stopProcess(pid) {
+    if (process.platform === "win32") {
+        return;
+    }
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.includes("ESRCH")) {
+            throw error;
+        }
+    }
+    await sleep(400);
+    try {
+        process.kill(pid, 0);
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // Process already exited.
+    }
+}
+export async function stopChildProcess(child) {
+    if (child.pid === undefined) {
+        return;
+    }
+    await stopProcess(child.pid);
+}
+export async function stopStaleGuiServers(ports = [STABLE_GUI_PORT, ...STABLE_GUI_FALLBACK_PORTS]) {
+    const stopped = [];
+    for (const port of ports) {
+        const listeners = await listPortListeners(port);
+        for (const listener of listeners) {
+            const command = listener.command || (await readProcessCommand(listener.pid));
+            if (!looksLikeGuiDevServer(command)) {
+                continue;
+            }
+            await stopProcess(listener.pid);
+            stopped.push({ pid: listener.pid, port, command });
+        }
+    }
+    if (stopped.length > 0) {
+        await sleep(500);
+    }
+    return { stopped };
+}
+export async function assertStableGuiPortAvailable(port = STABLE_GUI_PORT, host = STABLE_GUI_HOST) {
+    const listeners = await listPortListeners(port);
+    if (listeners.length === 0) {
+        return;
+    }
+    const blocking = [];
+    for (const listener of listeners) {
+        const command = listener.command || (await readProcessCommand(listener.pid));
+        if (looksLikeGuiDevServer(command)) {
+            await stopProcess(listener.pid);
+            await sleep(400);
+            continue;
+        }
+        blocking.push(`PID ${listener.pid}${command ? ` (${command})` : ""} on port ${port}`);
+    }
+    const remaining = await listPortListeners(port);
+    if (remaining.length > 0) {
+        const details = blocking.length
+            ? blocking.join("; ")
+            : remaining
+                .map((listener) => `PID ${listener.pid} on port ${port}`)
+                .join("; ");
+        throw new Error(`Port ${port} on ${host} is occupied by a non-GUI process: ${details}. Free port ${port} before running harness:configure:stable.`);
+    }
+}
+export async function cleanGuiNextCache(repoRoot) {
+    const nextDir = path.join(repoRoot, "apps", "gui", ".next");
+    await fs.rm(nextDir, { recursive: true, force: true });
+    return nextDir;
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=dev-server-process.js.map

package/dist/gui/dev-server-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server-process.js","sourceRoot":"","sources":["../../src/gui/dev-server-process.ts"],"names":[],"mappings":"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"}

package/dist/gui/port.d.ts

@@ -0,0 +1,17 @@
+export interface GuiPortOptions {
+    host?: string;
+    port?: number;
+    envPort?: string;
+    maxAttempts?: number;
+}
+export interface GuiPortResolution {
+    host: string;
+    port: number;
+    requestedPort: number;
+}
+export declare const DEFAULT_GUI_HOST = "localhost";
+export declare const DEFAULT_GUI_PORT = 3000;
+export declare function resolveRequestedGuiPort(options?: GuiPortOptions): number;
+export declare function resolveGuiHost(options?: GuiPortOptions): string;
+export declare function resolveAvailableGuiPort(options?: GuiPortOptions): Promise<GuiPortResolution>;
+//# sourceMappingURL=port.d.ts.map

package/dist/gui/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/gui/port.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAcxE;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAG/D;AAmBD,wBAAsB,uBAAuB,CAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAmB5B"}

package/dist/gui/port.js

@@ -0,0 +1,50 @@
+import net from "node:net";
+export const DEFAULT_GUI_HOST = "localhost";
+export const DEFAULT_GUI_PORT = 3000;
+export function resolveRequestedGuiPort(options) {
+    if (options?.port !== undefined) {
+        return options.port;
+    }
+    const envPort = options?.envPort ?? process.env.HARNESS_GUI_PORT;
+    if (envPort?.trim()) {
+        const parsed = Number.parseInt(envPort.trim(), 10);
+        if (!Number.isNaN(parsed) && parsed > 0 && parsed <= 65535) {
+            return parsed;
+        }
+    }
+    return DEFAULT_GUI_PORT;
+}
+export function resolveGuiHost(options) {
+    const host = options?.host ?? process.env.HARNESS_GUI_HOST ?? DEFAULT_GUI_HOST;
+    return host.trim() || DEFAULT_GUI_HOST;
+}
+function isPortAvailable(host, port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.unref();
+        server.once("error", () => {
+            resolve(false);
+        });
+        server.listen({ host, port }, () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+    });
+}
+export async function resolveAvailableGuiPort(options) {
+    const host = resolveGuiHost(options);
+    const requestedPort = resolveRequestedGuiPort(options);
+    const maxAttempts = options?.maxAttempts ?? 50;
+    for (let offset = 0; offset < maxAttempts; offset += 1) {
+        const candidate = requestedPort + offset;
+        if (candidate > 65535) {
+            break;
+        }
+        if (await isPortAvailable(host, candidate)) {
+            return { host, port: candidate, requestedPort };
+        }
+    }
+    throw new Error(`No available GUI port found starting at ${requestedPort} on ${host}`);
+}
+//# sourceMappingURL=port.js.map

package/dist/gui/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/gui/port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAe3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACjE,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3D,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAC/E,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,gBAAgB,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAY;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;YACjC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAwB;IAExB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;IAE/C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;QACzC,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;YACtB,MAAM;QACR,CAAC;QAED,IAAI,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,2CAA2C,aAAa,OAAO,IAAI,EAAE,CACtE,CAAC;AACJ,CAAC"}

package/dist/gui/repo-root.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveHarnessRepoRoot(startDir?: string): string;
+export declare function defaultHarnessRepoRootFromModule(): string;
+export declare function normalizeHarnessEnvPaths(cwd: string): void;
+//# sourceMappingURL=repo-root.d.ts.map

package/dist/gui/repo-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root.d.ts","sourceRoot":"","sources":["../../src/gui/repo-root.ts"],"names":[],"mappings":"AAQA,wBAAgB,sBAAsB,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAoCvE;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAKzD;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO1D"}

package/dist/gui/repo-root.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadHarnessDotenv } from "../config/load-dotenv.js";
+const HARNESS_PACKAGE_NAME = "agentic-product-development-harness";
+const P_DEV_HOME_ENV = "P_DEV_HOME";
+export function resolveHarnessRepoRoot(startDir = process.cwd()) {
+    const fromEnv = process.env.HARNESS_REPO_ROOT?.trim();
+    if (fromEnv) {
+        return path.resolve(fromEnv);
+    }
+    const fromWorkspace = process.env[P_DEV_HOME_ENV]?.trim();
+    if (fromWorkspace) {
+        return path.resolve(fromWorkspace);
+    }
+    let current = path.resolve(startDir);
+    while (true) {
+        const packageJsonPath = path.join(current, "package.json");
+        if (existsSync(packageJsonPath)) {
+            try {
+                const raw = readFileSync(packageJsonPath, "utf8");
+                const parsed = JSON.parse(raw);
+                if (parsed.name === HARNESS_PACKAGE_NAME) {
+                    return current;
+                }
+            }
+            catch {
+                // keep walking
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    throw new Error(`Could not resolve harness repo root from ${startDir}. Set HARNESS_REPO_ROOT or run harness:gui from the repo.`);
+}
+export function defaultHarnessRepoRootFromModule() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+}
+export function normalizeHarnessEnvPaths(cwd) {
+    loadHarnessDotenv(cwd);
+    const configPath = process.env.HARNESS_CONFIG_PATH?.trim();
+    if (configPath && !path.isAbsolute(configPath)) {
+        process.env.HARNESS_CONFIG_PATH = path.resolve(cwd, configPath);
+    }
+}
+//# sourceMappingURL=repo-root.js.map

package/dist/gui/repo-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root.js","sourceRoot":"","sources":["../../src/gui/repo-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,oBAAoB,GAAG,qCAAqC,CAAC;AACnE,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,MAAM,UAAU,sBAAsB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;gBACpD,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;oBACzC,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4CAA4C,QAAQ,2DAA2D,CAChH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO,IAAI,CAAC,OAAO,CACjB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/gui/start-configure-stable.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=start-configure-stable.d.ts.map

package/dist/gui/start-configure-stable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-configure-stable.d.ts","sourceRoot":"","sources":["../../src/gui/start-configure-stable.ts"],"names":[],"mappings":""}

package/dist/gui/start-configure-stable.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { CANONICAL_CONFIGURE_URL, checkConfigurePageHealth, waitForConfigureServer, } from "./configure-health.js";
+import { STABLE_GUI_HOST, STABLE_GUI_PORT, assertStableGuiPortAvailable, cleanGuiNextCache, stopChildProcess, stopStaleGuiServers, } from "./dev-server-process.js";
+import { resolveHarnessRepoRoot } from "./repo-root.js";
+const STARTUP_TIMEOUT_MS = 90_000;
+async function main() {
+    const repoRoot = resolveHarnessRepoRoot(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."));
+    const guiDir = path.join(repoRoot, "apps", "gui");
+    const baseUrl = `http://${STABLE_GUI_HOST}:${STABLE_GUI_PORT}`;
+    console.log("Preparing stable Configure GUI dev server…");
+    const stopped = await stopStaleGuiServers();
+    if (stopped.stopped.length > 0) {
+        for (const entry of stopped.stopped) {
+            console.log(`Stopped stale GUI dev server on port ${entry.port} (PID ${entry.pid}).`);
+        }
+    }
+    await assertStableGuiPortAvailable(STABLE_GUI_PORT, STABLE_GUI_HOST);
+    let cleanedCache = false;
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        const child = spawnNextDev(repoRoot, guiDir);
+        try {
+            await waitForConfigureServer(baseUrl, STARTUP_TIMEOUT_MS);
+            const health = await checkConfigurePageHealth(CANONICAL_CONFIGURE_URL);
+            if (health.ok) {
+                printReadyBanner();
+                await waitForExit(child);
+                return;
+            }
+            console.error(`Configure GUI health check failed: ${health.reason ?? "unknown error"}`);
+        }
+        finally {
+            await stopChildProcess(child);
+        }
+        if (attempt === 0) {
+            const nextDir = await cleanGuiNextCache(repoRoot);
+            cleanedCache = true;
+            console.log(`Cleaned safe GUI cache: ${nextDir}`);
+            console.log("Restarting Configure GUI once after cache cleanup…");
+            continue;
+        }
+        throw new Error(cleanedCache
+            ? "Configure GUI still failed the styling health check after cleaning apps/gui/.next."
+            : "Configure GUI failed the styling health check.");
+    }
+}
+function spawnNextDev(repoRoot, guiDir) {
+    const nextBin = path.join(repoRoot, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
+    console.log(`Starting Configure GUI at http://${STABLE_GUI_HOST}:${STABLE_GUI_PORT}/settings/configure`);
+    return spawn(nextBin, ["dev", "--hostname", STABLE_GUI_HOST, "--port", String(STABLE_GUI_PORT)], {
+        cwd: guiDir,
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            HARNESS_REPO_ROOT: repoRoot,
+            HARNESS_GUI_HOST: STABLE_GUI_HOST,
+            HARNESS_GUI_PORT: String(STABLE_GUI_PORT),
+        },
+    });
+}
+function printReadyBanner() {
+    console.log("");
+    console.log("Configure GUI is ready.");
+    console.log(`Canonical URL: ${CANONICAL_CONFIGURE_URL}`);
+    console.log("Use this URL in your own terminal session. localhost and 127.0.0.1 are equivalent loopback hosts; this harness uses localhost:3000 as the operator convention.");
+    console.log("If the page looks unstyled, stop the server and run npm run harness:configure:stable again to clean apps/gui/.next and restart.");
+    console.log("");
+}
+function waitForExit(child) {
+    return new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("exit", (code, signal) => {
+            if (signal) {
+                reject(new Error(`Configure GUI exited from signal ${signal}`));
+                return;
+            }
+            if (code && code !== 0) {
+                reject(new Error(`Configure GUI exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`harness:configure:stable failed: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=start-configure-stable.js.map

package/dist/gui/start-configure-stable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-configure-stable.js","sourceRoot":"","sources":["../../src/gui/start-configure-stable.ts"],"names":[],"mappings":"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"}

package/dist/gui/start-gui.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=start-gui.d.ts.map

package/dist/gui/start-gui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-gui.d.ts","sourceRoot":"","sources":["../../src/gui/start-gui.ts"],"names":[],"mappings":""}

package/dist/gui/start-gui.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveAvailableGuiPort } from "./port.js";
+import { resolveHarnessRepoRoot } from "./repo-root.js";
+function parseCliOptions(argv) {
+    const options = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--port") {
+            const value = argv[index + 1];
+            if (!value) {
+                throw new Error("--port requires a number");
+            }
+            options.port = Number.parseInt(value, 10);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--port=")) {
+            options.port = Number.parseInt(arg.slice("--port=".length), 10);
+            continue;
+        }
+        if (arg === "--host") {
+            const value = argv[index + 1];
+            if (!value) {
+                throw new Error("--host requires a value");
+            }
+            options.host = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--host=")) {
+            options.host = arg.slice("--host=".length);
+            continue;
+        }
+        if (arg === "--route") {
+            const value = argv[index + 1];
+            if (!value) {
+                throw new Error("--route requires a path");
+            }
+            options.route = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--route=")) {
+            options.route = arg.slice("--route=".length);
+        }
+    }
+    return options;
+}
+async function main() {
+    const cli = parseCliOptions(process.argv.slice(2));
+    const { host, port, requestedPort } = await resolveAvailableGuiPort({
+        host: cli.host,
+        port: cli.port,
+    });
+    const repoRoot = resolveHarnessRepoRoot(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."));
+    const guiDir = path.join(repoRoot, "apps", "gui");
+    const route = cli.route ?? "/settings/configure";
+    const url = `http://${host}:${port}${route}`;
+    if (port !== requestedPort) {
+        console.warn(`Port ${requestedPort} was busy. Using ${port} instead. For a fixed localhost:3000 server, run npm run harness:configure:stable.`);
+    }
+    console.log(`Starting Product Development Harness GUI at ${url}`);
+    const nextBin = path.join(repoRoot, "node_modules", ".bin", process.platform === "win32" ? "next.cmd" : "next");
+    const child = spawn(nextBin, ["dev", "--hostname", host, "--port", String(port)], {
+        cwd: guiDir,
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            HARNESS_REPO_ROOT: repoRoot,
+            HARNESS_GUI_HOST: host,
+            HARNESS_GUI_PORT: String(port),
+        },
+    });
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+            return;
+        }
+        process.exit(code ?? 0);
+    });
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`harness:gui failed: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=start-gui.js.map

package/dist/gui/start-gui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-gui.js","sourceRoot":"","sources":["../../src/gui/start-gui.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { createProgram } from "./cli/program.js";
+import { finalizeCliExit } from "./cli/finalize-exit.js";
+import { loadHarnessDotenv } from "./config/load-dotenv.js";
+loadHarnessDotenv();
+const program = createProgram();
+await program.parseAsync(process.argv);
+finalizeCliExit(process.exitCode);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,iBAAiB,EAAE,CAAC;AAEpB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/linear/client.d.ts

@@ -0,0 +1,14 @@
+export interface LinearIssueSnapshot {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string | null;
+    status: string | null;
+    projectName: string | null;
+    teamName: string | null;
+    teamId: string | null;
+    url: string | null;
+}
+export declare function fetchLinearIssue(issueKey: string, apiKey: string): Promise<LinearIssueSnapshot>;
+export declare function pingLinear(apiKey: string): Promise<string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/linear/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/linear/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhE"}

package/dist/linear/client.js

@@ -0,0 +1,30 @@
+import { LinearClient } from "@linear/sdk";
+export async function fetchLinearIssue(issueKey, apiKey) {
+    const client = new LinearClient({ apiKey });
+    const issue = await client.issue(issueKey);
+    if (!issue) {
+        throw new Error(`Linear issue not found: ${issueKey}`);
+    }
+    const [state, project, team] = await Promise.all([
+        issue.state,
+        issue.project,
+        issue.team,
+    ]);
+    return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? null,
+        status: state?.name ?? null,
+        projectName: project?.name ?? null,
+        teamName: team?.name ?? null,
+        teamId: team?.id ?? null,
+        url: issue.url ?? null,
+    };
+}
+export async function pingLinear(apiKey) {
+    const client = new LinearClient({ apiKey });
+    const viewer = await client.viewer;
+    return viewer.name ?? viewer.email ?? viewer.id;
+}
+//# sourceMappingURL=client.js.map

package/dist/linear/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/linear/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,IAAI;KACX,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,IAAI;QAC3B,WAAW,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI;QAClC,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QAC5B,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,IAAI;QACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc;IAC7C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;IACnC,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC;AAClD,CAAC"}

package/dist/linear/comment-card.d.ts

@@ -0,0 +1,24 @@
+export interface HarnessCommentLink {
+    label: string;
+    url: string;
+}
+export interface HarnessCommentCardInput {
+    phaseLabel: string;
+    pmSection?: string[];
+    engineerSection?: string[];
+    footer: string;
+}
+export declare function formatLinksAsMarkdown(links: HarnessCommentLink[]): string[];
+export declare function buildHarnessComment(input: HarnessCommentCardInput): string;
+export interface MinimalHarnessCommentInput {
+    phaseLabel: string;
+    links?: HarnessCommentLink[];
+    note?: string;
+    footer?: string;
+}
+/** Phase-start comments with links only — no PM/engineer sections. */
+export declare function buildMinimalHarnessComment(input: MinimalHarnessCommentInput): string;
+/** Strips HTML comments so tests can assert visible markdown only. */
+export declare function getVisibleCommentBody(body: string): string;
+export declare function formatBulletList(items: string[]): string[];
+//# sourceMappingURL=comment-card.d.ts.map

package/dist/linear/comment-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-card.d.ts","sourceRoot":"","sources":["../../src/linear/comment-card.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAuB1E;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,0BAA0B,GAChC,MAAM,CAaR;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE1D"}