p-dev-harness 0.3.0

package/dist/linear/writer.d.ts

@@ -0,0 +1,36 @@
+import { LinearClient } from "@linear/sdk";
+import type { LinearIssueSnapshot } from "./client.js";
+import { type HandoffCommentFooterInput, type RevisionCommentFooterInput, type MergeCommentFooterInput, type HarnessCommentFooterInput, type ProductionSyncCommentFooterInput, type PhaseStartPhase } from "./comments.js";
+export interface LinearCommentRecord {
+    id: string;
+    body: string;
+    createdAt?: string;
+}
+export declare function listIssueComments(client: LinearClient, issueId: string): Promise<LinearCommentRecord[]>;
+export declare function transitionIssueStatus(client: LinearClient, issue: LinearIssueSnapshot, statusName: string): Promise<void>;
+export declare function postIssueComment(client: LinearClient, issueId: string, body: string): Promise<string>;
+export declare function postPlanningComment(client: LinearClient, issueId: string, planBody: string, footer: HarnessCommentFooterInput): Promise<string>;
+export declare function postHandoffComment(client: LinearClient, issueId: string, summaryBody: string, footer: HandoffCommentFooterInput): Promise<string>;
+export declare function postRevisionComment(client: LinearClient, issueId: string, summaryBody: string, footer: RevisionCommentFooterInput): Promise<string>;
+export declare function postMergeCompletionComment(client: LinearClient, issueId: string, summaryBody: string, footer: MergeCommentFooterInput): Promise<string>;
+export declare function postProductionSyncComment(client: LinearClient, issueId: string, summaryBody: string, footer: ProductionSyncCommentFooterInput): Promise<string>;
+export interface PostPhaseStartCommentInput {
+    orchestratorMarker: string;
+    phase: PhaseStartPhase;
+    runId: string;
+    issueKey: string;
+    targetRepo: string;
+    baseBranch?: string;
+    model: string;
+    promptVersion: string;
+    branch?: string;
+    prUrl?: string;
+    cursorAgentId?: string;
+    cursorRunId?: string;
+}
+export declare function postPhaseStartCommentIfNeeded(client: LinearClient, issueId: string, input: PostPhaseStartCommentInput): Promise<string | null>;
+export declare function postErrorComment(client: LinearClient, issueId: string, message: string, footer: MergeCommentFooterInput, phase?: "planning" | "implementation" | "handoff" | "revision" | "merge" | "production_sync", options?: {
+    errorClassification?: string;
+}): Promise<string>;
+export declare function createLinearClient(apiKey: string): LinearClient;
+//# sourceMappingURL=writer.d.ts.map

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

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

package/dist/linear/writer.js

@@ -0,0 +1,105 @@
+import { LinearClient } from "@linear/sdk";
+import { resolveWorkflowStateId } from "./states.js";
+import { formatHarnessCommentFooter, formatHandoffComment, formatPlanningComment, buildErrorCommentBody, formatRevisionComment, formatMergeComment, formatProductionSyncComment, formatPhaseStartComment, findPhaseStartMarker, } from "./comments.js";
+import { getGitHubActionsRunUrl } from "../github/actions-url.js";
+export async function listIssueComments(client, issueId) {
+    const issue = await client.issue(issueId);
+    if (!issue) {
+        throw new Error(`Linear issue not found: ${issueId}`);
+    }
+    const connection = await issue.comments();
+    return (connection.nodes ?? []).map((comment) => ({
+        id: comment.id,
+        body: comment.body,
+        createdAt: comment.createdAt?.toISOString(),
+    }));
+}
+export async function transitionIssueStatus(client, issue, statusName) {
+    if (!issue.teamId) {
+        throw new Error(`Issue ${issue.identifier} is missing teamId`);
+    }
+    const stateId = await resolveWorkflowStateId(client, issue.teamId, statusName);
+    const linearIssue = await client.issue(issue.id);
+    if (!linearIssue) {
+        throw new Error(`Linear issue not found: ${issue.id}`);
+    }
+    const payload = await linearIssue.update({ stateId });
+    if (!payload.success) {
+        throw new Error(`Failed to transition issue to ${statusName}`);
+    }
+}
+export async function postIssueComment(client, issueId, body) {
+    const payload = await client.createComment({ issueId, body });
+    if (!payload.success) {
+        throw new Error("Failed to create Linear comment");
+    }
+    const comment = await payload.comment;
+    return comment?.id ?? "unknown";
+}
+export async function postPlanningComment(client, issueId, planBody, footer) {
+    const body = formatPlanningComment(planBody, footer);
+    return postIssueComment(client, issueId, body);
+}
+export async function postHandoffComment(client, issueId, summaryBody, footer) {
+    const body = formatHandoffComment(summaryBody, footer);
+    return postIssueComment(client, issueId, body);
+}
+export async function postRevisionComment(client, issueId, summaryBody, footer) {
+    const body = formatRevisionComment(summaryBody, footer);
+    return postIssueComment(client, issueId, body);
+}
+export async function postMergeCompletionComment(client, issueId, summaryBody, footer) {
+    const body = formatMergeComment(summaryBody, footer);
+    return postIssueComment(client, issueId, body);
+}
+export async function postProductionSyncComment(client, issueId, summaryBody, footer) {
+    const body = formatProductionSyncComment(summaryBody, footer);
+    return postIssueComment(client, issueId, body);
+}
+export async function postPhaseStartCommentIfNeeded(client, issueId, input) {
+    const comments = await listIssueComments(client, issueId);
+    if (findPhaseStartMarker(comments, input.orchestratorMarker, input.phase, input.runId)) {
+        return null;
+    }
+    const githubActionsRunUrl = getGitHubActionsRunUrl();
+    const bodyInput = {
+        issueKey: input.issueKey,
+        targetRepo: input.targetRepo,
+        baseBranch: input.baseBranch,
+        branch: input.branch,
+        prUrl: input.prUrl,
+        githubActionsRunUrl,
+        cursorAgentId: input.cursorAgentId,
+        cursorRunId: input.cursorRunId,
+    };
+    const body = formatPhaseStartComment(input.phase, bodyInput, {
+        orchestratorMarker: input.orchestratorMarker,
+        runId: input.runId,
+        cursorAgentId: input.cursorAgentId,
+        cursorRunId: input.cursorRunId,
+        model: input.model,
+        promptVersion: input.promptVersion,
+        targetRepo: input.targetRepo,
+        baseBranch: input.baseBranch,
+        branch: input.branch,
+        prUrl: input.prUrl,
+        githubActionsRunUrl: githubActionsRunUrl ?? undefined,
+    });
+    return postIssueComment(client, issueId, body);
+}
+export async function postErrorComment(client, issueId, message, footer, phase = "planning", options) {
+    const body = `${buildErrorCommentBody(phase, message, {
+        githubActionsRunUrl: footer.githubActionsRunUrl ?? getGitHubActionsRunUrl(),
+        errorClassification: options?.errorClassification,
+        targetRepo: footer.targetRepo,
+        branch: footer.branch,
+        prUrl: footer.prUrl,
+        baseBranch: footer.baseBranch,
+        harnessRunId: footer.runId,
+    })}\n\n${formatHarnessCommentFooter(footer)}`;
+    return postIssueComment(client, issueId, body);
+}
+export function createLinearClient(apiKey) {
+    return new LinearClient({ apiKey });
+}
+//# sourceMappingURL=writer.js.map

package/dist/linear/writer.js.map

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

package/dist/p-dev/browser.d.ts

@@ -0,0 +1,9 @@
+import { execFile } from "node:child_process";
+declare const execFileAsync: typeof execFile.__promisify__;
+export interface BrowserOpener {
+    open(url: string): Promise<void>;
+}
+export declare function createMacOsBrowserOpener(execFileImpl?: typeof execFileAsync): BrowserOpener;
+export declare const defaultBrowserOpener: BrowserOpener;
+export {};
+//# sourceMappingURL=browser.d.ts.map

package/dist/p-dev/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/p-dev/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,QAAA,MAAM,aAAa,+BAAsB,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CACtC,YAAY,GAAE,OAAO,aAA6B,GACjD,aAAa,CAYf;AAED,eAAO,MAAM,oBAAoB,eAA6B,CAAC"}

package/dist/p-dev/browser.js

@@ -0,0 +1,15 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export function createMacOsBrowserOpener(execFileImpl = execFileAsync) {
+    return {
+        async open(url) {
+            if (process.platform !== "darwin") {
+                throw new Error("p-dev browser launch is macOS-only in this packaging spike. Re-open the printed Configure URL manually.");
+            }
+            await execFileImpl("open", [url]);
+        },
+    };
+}
+export const defaultBrowserOpener = createMacOsBrowserOpener();
+//# sourceMappingURL=browser.js.map

package/dist/p-dev/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/p-dev/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAM1C,MAAM,UAAU,wBAAwB,CACtC,eAAqC,aAAa;IAElD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,GAAW;YACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,EAAE,CAAC"}

package/dist/p-dev/cli.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_CONFIGURE_ROUTE = "/settings/configure";
+export interface PDevCliOptions {
+    host?: string;
+    port?: number;
+    workspace?: string;
+    route: string;
+    openBrowser: boolean;
+}
+export declare function parsePDevCliOptions(argv: string[]): PDevCliOptions;
+//# sourceMappingURL=cli.d.ts.map

package/dist/p-dev/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/p-dev/cli.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAkFlE"}

package/dist/p-dev/cli.js

@@ -0,0 +1,73 @@
+export const DEFAULT_CONFIGURE_ROUTE = "/settings/configure";
+export function parsePDevCliOptions(argv) {
+    const options = {
+        route: DEFAULT_CONFIGURE_ROUTE,
+        openBrowser: true,
+    };
+    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 === "--workspace") {
+            const value = argv[index + 1];
+            if (!value) {
+                throw new Error("--workspace requires a path");
+            }
+            options.workspace = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--workspace=")) {
+            options.workspace = arg.slice("--workspace=".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);
+            continue;
+        }
+        if (arg === "--no-open") {
+            options.openBrowser = false;
+            continue;
+        }
+    }
+    if (options.port !== undefined) {
+        if (!Number.isFinite(options.port) || options.port <= 0 || options.port > 65535) {
+            throw new Error("--port must be a valid TCP port between 1 and 65535");
+        }
+    }
+    return options;
+}
+//# sourceMappingURL=cli.js.map

package/dist/p-dev/cli.js.map

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

package/dist/p-dev/launch.d.ts

@@ -0,0 +1,20 @@
+import { spawn } from "node:child_process";
+import type { BrowserOpener } from "./browser.js";
+import type { PDevCliOptions } from "./cli.js";
+export declare const STARTUP_TIMEOUT_MS = 90000;
+export interface LaunchPDevOptions {
+    argv?: string[];
+    moduleUrl: string;
+    browserOpener?: BrowserOpener;
+    spawnImpl?: typeof spawn;
+}
+export interface LaunchPDevResult {
+    url: string;
+    workspaceDir: string;
+    packageRoot: string;
+    port: number;
+    host: string;
+}
+export declare function launchPDev(options: LaunchPDevOptions): Promise<LaunchPDevResult>;
+export type { PDevCliOptions };
+//# sourceMappingURL=launch.d.ts.map

package/dist/p-dev/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/p-dev/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA0B/C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAqH3B;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/p-dev/launch.js

@@ -0,0 +1,107 @@
+import { spawn } from "node:child_process";
+import { defaultBrowserOpener } from "./browser.js";
+import { parsePDevCliOptions } from "./cli.js";
+import { assertNodeVersion } from "./node-version.js";
+import { resolveGuiDirectory, resolvePackageRootFromModule, resolveTemplatesDirectory, } from "./package-paths.js";
+import { createShutdownController } from "./shutdown.js";
+import { resolveNextBin } from "./next-bin.js";
+import { checkConfigurePageHealth, waitForConfigureServer, } from "../gui/configure-health.js";
+import { resolveAvailableGuiPort } from "../gui/port.js";
+import { P_DEV_PACKAGE_VERSION_ENV, readPDevPackageVersionFromPackageRoot, } from "./package-version.js";
+import { isPathInsidePackageInstall, P_DEV_HOME_ENV, resolveWorkspaceDir, seedWorkspaceTemplates, } from "./workspace.js";
+export const STARTUP_TIMEOUT_MS = 90_000;
+function buildConfigureUrl(host, port, route) {
+    const normalizedRoute = route.startsWith("/") ? route : `/${route}`;
+    return `http://${host}:${port}${normalizedRoute}`;
+}
+export async function launchPDev(options) {
+    assertNodeVersion();
+    const cli = parsePDevCliOptions(options.argv ?? process.argv.slice(2));
+    const packageRoot = resolvePackageRootFromModule(options.moduleUrl);
+    const guiDir = resolveGuiDirectory(packageRoot);
+    const templatesDir = resolveTemplatesDirectory(packageRoot);
+    const workspace = resolveWorkspaceDir({
+        cliWorkspace: cli.workspace,
+        envWorkspace: process.env[P_DEV_HOME_ENV],
+    });
+    if (isPathInsidePackageInstall(workspace.workspaceDir, packageRoot)) {
+        throw new Error(`Refusing to use package install directory as workspace (${workspace.workspaceDir}). Set ${P_DEV_HOME_ENV} or pass --workspace to a writable directory outside the installed package.`);
+    }
+    await seedWorkspaceTemplates({
+        workspaceDir: workspace.workspaceDir,
+        templatesDir,
+    });
+    const { host, port, requestedPort } = await resolveAvailableGuiPort({
+        host: cli.host,
+        port: cli.port,
+    });
+    const url = buildConfigureUrl(host, port, cli.route);
+    const nextBin = resolveNextBin(packageRoot);
+    const packagedVersion = readPDevPackageVersionFromPackageRoot(packageRoot);
+    const spawnImpl = options.spawnImpl ?? spawn;
+    const shutdown = createShutdownController();
+    if (port !== requestedPort) {
+        console.warn(`Port ${requestedPort} was busy. Using ${port} instead. Configure URL: ${url}`);
+    }
+    console.log(`Starting Product Development Harness Configure GUI at ${url}`);
+    console.log(`Operator workspace: ${workspace.workspaceDir}`);
+    const child = spawnImpl(process.execPath, [nextBin, "start", "--hostname", host, "--port", String(port)], {
+        cwd: guiDir,
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            [P_DEV_HOME_ENV]: workspace.workspaceDir,
+            HARNESS_REPO_ROOT: workspace.workspaceDir,
+            P_DEV_RUNTIME_MODE: "packaged",
+            [P_DEV_PACKAGE_VERSION_ENV]: packagedVersion,
+            HARNESS_GUI_HOST: host,
+            HARNESS_GUI_PORT: String(port),
+        },
+    });
+    shutdown.register(child);
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+            return;
+        }
+        process.exit(code ?? 0);
+    });
+    child.on("error", (error) => {
+        console.error(`p-dev failed to start Configure GUI: ${error.message}`);
+        process.exit(1);
+    });
+    const baseUrl = `http://${host}:${port}`;
+    await waitForConfigureServer(baseUrl, STARTUP_TIMEOUT_MS);
+    const health = await checkConfigurePageHealth(url);
+    if (!health.ok) {
+        await shutdown.cleanup();
+        throw new Error(health.reason ?? "Configure GUI health check failed after startup.");
+    }
+    console.log(`Configure GUI is ready at ${url}`);
+    if (cli.openBrowser) {
+        const browserOpener = options.browserOpener ?? defaultBrowserOpener;
+        await browserOpener.open(url);
+    }
+    await 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();
+        });
+    });
+    return {
+        url,
+        workspaceDir: workspace.workspaceDir,
+        packageRoot,
+        port,
+        host,
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/p-dev/launch.js.map

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

package/dist/p-dev/main.d.ts

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

package/dist/p-dev/main.d.ts.map

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

package/dist/p-dev/main.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { launchPDev } from "./launch.js";
+await launchPDev({
+    moduleUrl: import.meta.url,
+}).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`p-dev failed: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/p-dev/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/p-dev/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;CAC3B,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC1B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/p-dev/next-bin.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveNextBin(packageRoot: string): string;
+//# sourceMappingURL=next-bin.d.ts.map

package/dist/p-dev/next-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-bin.d.ts","sourceRoot":"","sources":["../../src/p-dev/next-bin.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI1D"}

package/dist/p-dev/next-bin.js

@@ -0,0 +1,8 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+export function resolveNextBin(packageRoot) {
+    const requireFromPackage = createRequire(path.join(packageRoot, "package.json"));
+    const nextPackageJson = requireFromPackage.resolve("next/package.json");
+    return path.join(path.dirname(nextPackageJson), "dist", "bin", "next");
+}
+//# sourceMappingURL=next-bin.js.map

package/dist/p-dev/next-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-bin.js","sourceRoot":"","sources":["../../src/p-dev/next-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC"}

package/dist/p-dev/node-version.d.ts

@@ -0,0 +1,9 @@
+export declare const MIN_NODE_MAJOR = 22;
+export interface NodeVersionCheckResult {
+    ok: boolean;
+    message?: string;
+}
+export declare function parseNodeMajor(version: string): number;
+export declare function checkNodeVersion(version?: string, minMajor?: number): NodeVersionCheckResult;
+export declare function assertNodeVersion(version?: string, minMajor?: number): void;
+//# sourceMappingURL=node-version.d.ts.map

package/dist/p-dev/node-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.d.ts","sourceRoot":"","sources":["../../src/p-dev/node-version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,SAAkB,EACzB,QAAQ,SAAiB,GACxB,sBAAsB,CAiBxB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,SAAkB,EACzB,QAAQ,SAAiB,GACxB,IAAI,CAKN"}

package/dist/p-dev/node-version.js

@@ -0,0 +1,31 @@
+export const MIN_NODE_MAJOR = 22;
+export function parseNodeMajor(version) {
+    const match = /^v?(\d+)/.exec(version.trim());
+    if (!match?.[1]) {
+        return Number.NaN;
+    }
+    return Number.parseInt(match[1], 10);
+}
+export function checkNodeVersion(version = process.version, minMajor = MIN_NODE_MAJOR) {
+    const major = parseNodeMajor(version);
+    if (!Number.isFinite(major)) {
+        return {
+            ok: false,
+            message: `Could not parse Node.js version from "${version}".`,
+        };
+    }
+    if (major < minMajor) {
+        return {
+            ok: false,
+            message: `p-dev requires Node.js ${minMajor}+. The active version is ${version}. Install a supported Node release and retry.`,
+        };
+    }
+    return { ok: true };
+}
+export function assertNodeVersion(version = process.version, minMajor = MIN_NODE_MAJOR) {
+    const result = checkNodeVersion(version, minMajor);
+    if (!result.ok) {
+        throw new Error(result.message);
+    }
+}
+//# sourceMappingURL=node-version.js.map

package/dist/p-dev/node-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.js","sourceRoot":"","sources":["../../src/p-dev/node-version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAOjC,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAO,GAAG,OAAO,CAAC,OAAO,EACzB,QAAQ,GAAG,cAAc;IAEzB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,yCAAyC,OAAO,IAAI;SAC9D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,0BAA0B,QAAQ,4BAA4B,OAAO,+CAA+C;SAC9H,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAO,GAAG,OAAO,CAAC,OAAO,EACzB,QAAQ,GAAG,cAAc;IAEzB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/p-dev/package-paths.d.ts

@@ -0,0 +1,5 @@
+export declare const P_DEV_PACKAGE_NAME = "p-dev-harness";
+export declare function resolvePackageRootFromModule(moduleUrl: string): string;
+export declare function resolveGuiDirectory(packageRoot: string): string;
+export declare function resolveTemplatesDirectory(packageRoot: string): string;
+//# sourceMappingURL=package-paths.d.ts.map

package/dist/p-dev/package-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-paths.d.ts","sourceRoot":"","sources":["../../src/p-dev/package-paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA4BtE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/p-dev/package-paths.js

@@ -0,0 +1,34 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export const P_DEV_PACKAGE_NAME = "p-dev-harness";
+export function resolvePackageRootFromModule(moduleUrl) {
+    let current = path.resolve(path.dirname(fileURLToPath(moduleUrl)));
+    while (true) {
+        const packageJsonPath = path.join(current, "package.json");
+        if (existsSync(packageJsonPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+                if (parsed.name === P_DEV_PACKAGE_NAME) {
+                    return current;
+                }
+            }
+            catch {
+                // keep walking
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    throw new Error(`Could not resolve ${P_DEV_PACKAGE_NAME} package root from ${moduleUrl}.`);
+}
+export function resolveGuiDirectory(packageRoot) {
+    return path.join(packageRoot, "gui");
+}
+export function resolveTemplatesDirectory(packageRoot) {
+    return path.join(packageRoot, "templates");
+}
+//# sourceMappingURL=package-paths.js.map

package/dist/p-dev/package-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-paths.js","sourceRoot":"","sources":["../../src/p-dev/package-paths.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;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnE,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,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAE9D,CAAC;gBACF,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBACvC,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,qBAAqB,kBAAkB,sBAAsB,SAAS,GAAG,CAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC"}

package/dist/p-dev/package-version.d.ts

@@ -0,0 +1,6 @@
+export declare const P_DEV_PACKAGE_VERSION_ENV = "P_DEV_PACKAGE_VERSION";
+export declare function readHarnessPackageVersion(moduleUrl?: string): string;
+export declare function readPDevPackageVersionFromPackageRoot(packageRoot: string): string;
+export declare function validatePackagedRuntimeVersionValue(raw: string | undefined): string;
+export declare function resolveHarnessPackageVersion(env?: NodeJS.ProcessEnv, moduleUrl?: string): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/p-dev/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/p-dev/package-version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAKjE,wBAAgB,yBAAyB,CACvC,SAAS,SAAkB,GAC1B,MAAM,CAQR;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,GAClB,MAAM,CAWR;AAED,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAaR;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,SAAkB,GAC1B,MAAM,CAKR"}