@pi-harness/pi-harness 0.1.1

package/packages/cli/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAG,eAAe,CAAC;CAC1C;AAID,SAAS,WAAW,CAAC,IAAuB,EAAE,KAAa,EAAE,MAAc;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,GAAG,MAAM,mBAAmB,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,UAA8B,CAAC;IACnC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,eAAe,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM;QACR,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9D,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACpE,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YAC5B,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,IAAI,eAAe;gBAAE,MAAM,IAAI,aAAa,CAAC,sCAAsC,CAAC,CAAC;YACrF,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YAChD,eAAe,GAAG,IAAI,CAAC;YACvB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,IAAI,aAAa,CAAC,qCAAqC,CAAC,CAAC;YAC7F,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YAClD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,eAAe,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,gDAAgD,CAAC,CAAC;IAC3H,OAAO,UAAU,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE;QAC7D,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACrE,CAAC"}

package/packages/cli/dist/bin.d.ts

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

package/packages/cli/dist/bin.d.ts.map

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

package/packages/cli/dist/bin.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runCli } from "./main.js";
+import { shouldRelaunchForDevelopmentProfile, superviseDevelopmentProcess } from "./relaunch.js";
+const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const environment = {
+    cwd: process.cwd(),
+    agentDir: process.env.PI_AGENT_DIR ?? join(homedir(), ".pi", "agent"),
+    version: packageJson.version,
+    stdin: process.stdin,
+    stdout: process.stdout,
+    stderr: process.stderr,
+    shutdownTimeoutMs: 5_000,
+    forceExit(code) {
+        process.exit(code);
+    },
+    onSignal(listener) {
+        const signals = process.platform === "win32" ? ["SIGINT", "SIGTERM"] : ["SIGINT", "SIGTERM", "SIGHUP"];
+        const handlers = signals.map((signal) => {
+            const handler = () => listener(signal);
+            process.on(signal, handler);
+            return { signal, handler };
+        });
+        return () => {
+            for (const { signal, handler } of handlers)
+                process.off(signal, handler);
+        };
+    },
+};
+const args = process.argv.slice(2);
+if (shouldRelaunchForDevelopmentProfile(args, process.execArgv)) {
+    process.exitCode = await superviseDevelopmentProcess(process.execPath, ["--expose-internals", ...process.execArgv, fileURLToPath(import.meta.url), ...args], { stdio: "inherit" });
+}
+else {
+    process.exitCode = await runCli(args, environment);
+}
+//# sourceMappingURL=bin.js.map

package/packages/cli/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAuB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,mCAAmC,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEjG,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;AAEzH,MAAM,WAAW,GAAmB;IAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC;IACrE,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,iBAAiB,EAAE,KAAK;IACxB,SAAS,CAAC,IAAI;QACZ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,QAAQ,CAAC,QAAQ;QACf,MAAM,OAAO,GAAqB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3E,CAAC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,mCAAmC,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChE,OAAO,CAAC,QAAQ,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,oBAAoB,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACrL,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC"}

package/packages/cli/dist/main.d.ts

@@ -0,0 +1,14 @@
+import type { Readable, Writable } from "node:stream";
+export interface CliEnvironment {
+    readonly cwd: string;
+    readonly agentDir: string;
+    readonly version: string;
+    readonly stdin: Readable;
+    readonly stdout: Writable;
+    readonly stderr: Writable;
+    readonly shutdownTimeoutMs: number;
+    forceExit(code: number): void;
+    onSignal(listener: (signal: NodeJS.Signals) => void): () => void;
+}
+export declare function runCli(_args: readonly string[], _environment: CliEnvironment): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/packages/cli/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAkBD,wBAAsB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuHpG"}

package/packages/cli/dist/main.js

@@ -0,0 +1,148 @@
+import { readFile } from "node:fs/promises";
+import { bootHarness, provideLaunchContext, provideStdioContext, resolveProfileConfig } from "@pi-harness/core";
+import { CliUsageError, parseLauncherArgs } from "./args.js";
+import { NodeStdio } from "./node-stdio.js";
+import { PI_HARNESS_RESTART_EXIT_CODE } from "./relaunch.js";
+async function settleWithin(promise, timeoutMs) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve({ settled: false }), timeoutMs);
+    });
+    const result = await Promise.race([promise.then((value) => ({ settled: true, value })), timeout]);
+    if (timer !== undefined)
+        clearTimeout(timer);
+    return result;
+}
+function signalExitCode(signal) {
+    return signal === "SIGINT" ? 130 : signal === "SIGHUP" ? 129 : 143;
+}
+export async function runCli(_args, _environment) {
+    const args = _args;
+    const environment = _environment;
+    let invocation;
+    try {
+        invocation = parseLauncherArgs(args);
+    }
+    catch (error) {
+        environment.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return error instanceof CliUsageError ? 2 : 1;
+    }
+    if (invocation.mode === "help") {
+        environment.stdout.write("Usage: pih [--profile <name> | --config <path>] [--dump-config] [--] [--prompt <text> | <prompt>]\n");
+        return 0;
+    }
+    if (invocation.mode === "version") {
+        environment.stdout.write(`${environment.version}\n`);
+        return 0;
+    }
+    let configPath;
+    try {
+        configPath = await resolveProfileConfig({
+            ...(invocation.configPath === undefined ? { profile: invocation.profile ?? "default" } : { configPath: invocation.configPath }),
+            cwd: environment.cwd,
+        });
+        if (invocation.dumpConfig) {
+            environment.stdout.write(await readFile(configPath, "utf8"));
+            return 0;
+        }
+    }
+    catch (error) {
+        environment.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 2;
+    }
+    let harness;
+    let resultCode;
+    let forcedExit = false;
+    const forceExit = (code) => {
+        if (forcedExit)
+            return;
+        forcedExit = true;
+        environment.forceExit(code);
+    };
+    let requestedExit;
+    const requestedExitPromise = new Promise((resolve) => {
+        requestedExit = resolve;
+    });
+    let signalledExit;
+    const signalPromise = new Promise((resolve) => {
+        signalledExit = resolve;
+    });
+    const startupAbort = new AbortController();
+    const removeSignals = environment.onSignal((signal) => {
+        const code = signalExitCode(signal);
+        signalledExit?.(code);
+        startupAbort.abort(new Error(`Received ${signal}`));
+    });
+    try {
+        const stdio = new NodeStdio(environment.stdin, environment.stdout, environment.stderr);
+        const bootOutcome = bootHarness({
+            configPath,
+            signal: startupAbort.signal,
+            onFullReload() {
+                requestedExit?.(PI_HARNESS_RESTART_EXIT_CODE);
+            },
+            prepare(context) {
+                provideLaunchContext(context, {
+                    cwd: environment.cwd,
+                    agentDir: environment.agentDir,
+                    args: invocation.args,
+                    requestExit(code) {
+                        requestedExit?.(code);
+                    },
+                });
+                provideStdioContext(context, stdio);
+            },
+        }).then((booted) => ({ kind: "ready", harness: booted }), (error) => ({ kind: "error", error }));
+        const startup = await Promise.race([bootOutcome, signalPromise.then((code) => ({ kind: "signal", code }))]);
+        if (startup.kind === "signal") {
+            resultCode = startup.code;
+            const settled = await settleWithin(bootOutcome, environment.shutdownTimeoutMs);
+            if (!settled.settled) {
+                forceExit(startup.code);
+                return startup.code;
+            }
+            if (settled.value.kind === "ready")
+                harness = settled.value.harness;
+            return startup.code;
+        }
+        if (startup.kind === "error")
+            throw startup.error;
+        harness = startup.harness;
+        const application = harness.context.get("piApplication");
+        if (application === undefined)
+            throw new Error("Cordis profile did not provide a piApplication service");
+        const result = await Promise.race([
+            application.run().then((code) => ({ source: "application", code })),
+            requestedExitPromise.then((code) => ({ source: "request", code })),
+            signalPromise.then((code) => ({ source: "signal", code })),
+        ]);
+        resultCode = result.code;
+        if (result.source !== "application") {
+            const runtime = harness.context.get("piRuntime");
+            if (runtime !== undefined) {
+                const aborted = await settleWithin(runtime.abort().then(() => undefined, (error) => {
+                    environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+                }), environment.shutdownTimeoutMs);
+                if (!aborted.settled)
+                    forceExit(result.code);
+            }
+        }
+        return result.code;
+    }
+    catch (error) {
+        environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+        resultCode = 1;
+        return 1;
+    }
+    finally {
+        removeSignals();
+        if (harness !== undefined) {
+            const disposed = await settleWithin(harness.dispose().then(() => undefined, (error) => {
+                environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+            }), environment.shutdownTimeoutMs);
+            if (!disposed.settled)
+                forceExit(resultCode ?? 1);
+        }
+    }
+}
+//# sourceMappingURL=main.js.map

package/packages/cli/dist/main.js.map

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

package/packages/cli/dist/node-stdio.d.ts

@@ -0,0 +1,10 @@
+import type { Readable, Writable } from "node:stream";
+import type { PiHarnessStdio } from "@pi-harness/core";
+export declare class NodeStdio implements PiHarnessStdio {
+    #private;
+    constructor(input: Readable, output: Writable, error: Writable);
+    readPrompt(): Promise<string>;
+    writeOutput(text: string): void;
+    writeError(text: string): void;
+}
+//# sourceMappingURL=node-stdio.d.ts.map

package/packages/cli/dist/node-stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-stdio.d.ts","sourceRoot":"","sources":["../src/node-stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,qBAAa,SAAU,YAAW,cAAc;;gBAKlC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IAMxD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAenC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG/B"}

package/packages/cli/dist/node-stdio.js

@@ -0,0 +1,34 @@
+import { createInterface } from "node:readline/promises";
+export class NodeStdio {
+    #input;
+    #output;
+    #error;
+    constructor(input, output, error) {
+        this.#input = input;
+        this.#output = output;
+        this.#error = error;
+    }
+    async readPrompt() {
+        if (this.#input.isTTY === true) {
+            const readline = createInterface({ input: this.#input, output: this.#output });
+            try {
+                return await readline.question("> ");
+            }
+            finally {
+                readline.close();
+            }
+        }
+        this.#input.setEncoding("utf8");
+        let content = "";
+        for await (const chunk of this.#input)
+            content += String(chunk);
+        return content.trimEnd();
+    }
+    writeOutput(text) {
+        this.#output.write(text);
+    }
+    writeError(text) {
+        this.#error.write(text);
+    }
+}
+//# sourceMappingURL=node-stdio.js.map

package/packages/cli/dist/node-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-stdio.js","sourceRoot":"","sources":["../src/node-stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAMzD,MAAM,OAAO,SAAS;IACX,MAAM,CAAmB;IACzB,OAAO,CAAW;IAClB,MAAM,CAAW;IAE1B,YAAY,KAAe,EAAE,MAAgB,EAAE,KAAe;QAC5D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/packages/cli/dist/relaunch.d.ts

@@ -0,0 +1,5 @@
+import { type SpawnOptions } from "node:child_process";
+export declare const PI_HARNESS_RESTART_EXIT_CODE = 75;
+export declare function superviseDevelopmentProcess(command: string, args: readonly string[], options?: SpawnOptions): Promise<number>;
+export declare function shouldRelaunchForDevelopmentProfile(args: readonly string[], execArgv: readonly string[]): boolean;
+//# sourceMappingURL=relaunch.d.ts.map

package/packages/cli/dist/relaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relaunch.d.ts","sourceRoot":"","sources":["../src/relaunch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAS/C,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBvI;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQjH"}

package/packages/cli/dist/relaunch.js

@@ -0,0 +1,52 @@
+import { spawn } from "node:child_process";
+import { parseLauncherArgs } from "./args.js";
+export const PI_HARNESS_RESTART_EXIT_CODE = 75;
+function signalExitCode(signal) {
+    if (signal === "SIGINT")
+        return 130;
+    if (signal === "SIGHUP")
+        return 129;
+    if (signal === "SIGTERM")
+        return 143;
+    return 1;
+}
+export async function superviseDevelopmentProcess(command, args, options = {}) {
+    while (true) {
+        const result = await new Promise((resolve, reject) => {
+            const child = spawn(command, [...args], options);
+            const signals = process.platform === "win32" ? ["SIGINT", "SIGTERM"] : ["SIGINT", "SIGTERM", "SIGHUP"];
+            const handlers = signals.map((signal) => {
+                const handler = () => child.kill(signal);
+                process.on(signal, handler);
+                return { signal, handler };
+            });
+            const cleanup = () => {
+                for (const { signal, handler } of handlers)
+                    process.off(signal, handler);
+            };
+            child.once("error", (error) => {
+                cleanup();
+                reject(error);
+            });
+            child.once("exit", (code, signal) => {
+                cleanup();
+                resolve({ code, signal });
+            });
+        });
+        if (result.code === PI_HARNESS_RESTART_EXIT_CODE)
+            continue;
+        return result.code ?? signalExitCode(result.signal);
+    }
+}
+export function shouldRelaunchForDevelopmentProfile(args, execArgv) {
+    if (execArgv.includes("--expose-internals"))
+        return false;
+    try {
+        const invocation = parseLauncherArgs(args);
+        return invocation.mode === "run" && invocation.configPath === undefined && invocation.profile === "development" && !invocation.dumpConfig;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=relaunch.js.map

package/packages/cli/dist/relaunch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relaunch.js","sourceRoot":"","sources":["../src/relaunch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C,SAAS,cAAc,CAAC,MAA6B;IACnD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAAe,EAAE,IAAuB,EAAE,UAAwB,EAAE;IACpH,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAyD,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3G,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,OAAO,GAAqB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACzH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACzC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,QAAQ;oBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3E,CAAC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC5B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBAClC,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,4BAA4B;YAAE,SAAS;QAC3D,OAAO,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,IAAuB,EAAE,QAA2B;IACtG,IAAI,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,OAAO,KAAK,aAAa,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/packages/cli/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@pi-harness/cli",
+  "version": "0.1.1",
+  "description": "Plugin-first Pi Harness CLI",
+  "type": "module",
+  "bin": {
+    "pih": "./dist/bin.js"
+  },
+  "main": "./dist/main.js",
+  "types": "./dist/main.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@pi-harness/core": "0.1.1"
+  }
+}

package/packages/cli/src/args.ts

@@ -0,0 +1,50 @@
+export class CliUsageError extends Error {
+  override readonly name = "CliUsageError";
+}
+
+export type LauncherInvocation = { mode: "help" } | { mode: "version" } | { mode: "run"; profile?: string; configPath?: string; dumpConfig: boolean; args: string[] };
+
+function optionValue(args: readonly string[], index: number, option: string): string {
+  const value = args[index + 1];
+  if (value === undefined || value === "--") throw new CliUsageError(`${option} requires a value`);
+  return value;
+}
+
+export function parseLauncherArgs(args: readonly string[]): LauncherInvocation {
+  let profile = "default";
+  let profileExplicit = false;
+  let configPath: string | undefined;
+  let dumpConfig = false;
+  const applicationArgs: string[] = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--") {
+      applicationArgs.push(...args.slice(index + 1));
+      break;
+    }
+    if (arg === "--help" || arg === "-h") return { mode: "help" };
+    if (arg === "--version" || arg === "-v") return { mode: "version" };
+    if (arg === "--dump-config") {
+      dumpConfig = true;
+      continue;
+    }
+    if (arg === "--profile") {
+      if (profileExplicit) throw new CliUsageError("--profile may only be specified once");
+      profile = optionValue(args, index, "--profile");
+      profileExplicit = true;
+      index += 1;
+      continue;
+    }
+    if (arg === "--config") {
+      if (configPath !== undefined) throw new CliUsageError("--config may only be specified once");
+      configPath = optionValue(args, index, "--config");
+      index += 1;
+      continue;
+    }
+    applicationArgs.push(arg ?? "");
+  }
+  if (profileExplicit && configPath !== undefined) throw new CliUsageError("--profile and --config cannot be used together");
+  return configPath === undefined
+    ? { mode: "run", profile, dumpConfig, args: applicationArgs }
+    : { mode: "run", configPath, dumpConfig, args: applicationArgs };
+}

package/packages/cli/src/bin.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runCli, type CliEnvironment } from "./main.js";
+import { shouldRelaunchForDevelopmentProfile, superviseDevelopmentProcess } from "./relaunch.js";
+
+const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")) as { version: string };
+
+const environment: CliEnvironment = {
+  cwd: process.cwd(),
+  agentDir: process.env.PI_AGENT_DIR ?? join(homedir(), ".pi", "agent"),
+  version: packageJson.version,
+  stdin: process.stdin,
+  stdout: process.stdout,
+  stderr: process.stderr,
+  shutdownTimeoutMs: 5_000,
+  forceExit(code) {
+    process.exit(code);
+  },
+  onSignal(listener) {
+    const signals: NodeJS.Signals[] = process.platform === "win32" ? ["SIGINT", "SIGTERM"] : ["SIGINT", "SIGTERM", "SIGHUP"];
+    const handlers = signals.map((signal) => {
+      const handler = () => listener(signal);
+      process.on(signal, handler);
+      return { signal, handler };
+    });
+    return () => {
+      for (const { signal, handler } of handlers) process.off(signal, handler);
+    };
+  },
+};
+
+const args = process.argv.slice(2);
+if (shouldRelaunchForDevelopmentProfile(args, process.execArgv)) {
+  process.exitCode = await superviseDevelopmentProcess(process.execPath, ["--expose-internals", ...process.execArgv, fileURLToPath(import.meta.url), ...args], { stdio: "inherit" });
+} else {
+  process.exitCode = await runCli(args, environment);
+}

package/packages/cli/src/main.ts

@@ -0,0 +1,155 @@
+import { readFile } from "node:fs/promises";
+import type { Readable, Writable } from "node:stream";
+import { bootHarness, provideLaunchContext, provideStdioContext, resolveProfileConfig, type BootedHarness } from "@pi-harness/core";
+import { CliUsageError, parseLauncherArgs } from "./args.js";
+import { NodeStdio } from "./node-stdio.js";
+import { PI_HARNESS_RESTART_EXIT_CODE } from "./relaunch.js";
+
+export interface CliEnvironment {
+  readonly cwd: string;
+  readonly agentDir: string;
+  readonly version: string;
+  readonly stdin: Readable;
+  readonly stdout: Writable;
+  readonly stderr: Writable;
+  readonly shutdownTimeoutMs: number;
+  forceExit(code: number): void;
+  onSignal(listener: (signal: NodeJS.Signals) => void): () => void;
+}
+
+type BootOutcome = { kind: "ready"; harness: BootedHarness } | { kind: "error"; error: unknown };
+
+async function settleWithin<T>(promise: Promise<T>, timeoutMs: number): Promise<{ settled: true; value: T } | { settled: false }> {
+  let timer: NodeJS.Timeout | undefined;
+  const timeout = new Promise<{ settled: false }>((resolve) => {
+    timer = setTimeout(() => resolve({ settled: false }), timeoutMs);
+  });
+  const result = await Promise.race([promise.then((value) => ({ settled: true as const, value })), timeout]);
+  if (timer !== undefined) clearTimeout(timer);
+  return result;
+}
+
+function signalExitCode(signal: NodeJS.Signals): number {
+  return signal === "SIGINT" ? 130 : signal === "SIGHUP" ? 129 : 143;
+}
+
+export async function runCli(_args: readonly string[], _environment: CliEnvironment): Promise<number> {
+  const args = _args;
+  const environment = _environment;
+  let invocation: ReturnType<typeof parseLauncherArgs>;
+  try {
+    invocation = parseLauncherArgs(args);
+  } catch (error) {
+    environment.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    return error instanceof CliUsageError ? 2 : 1;
+  }
+  if (invocation.mode === "help") {
+    environment.stdout.write("Usage: pih [--profile <name> | --config <path>] [--dump-config] [--] [--prompt <text> | <prompt>]\n");
+    return 0;
+  }
+  if (invocation.mode === "version") {
+    environment.stdout.write(`${environment.version}\n`);
+    return 0;
+  }
+  let configPath: string;
+  try {
+    configPath = await resolveProfileConfig({
+      ...(invocation.configPath === undefined ? { profile: invocation.profile ?? "default" } : { configPath: invocation.configPath }),
+      cwd: environment.cwd,
+    });
+    if (invocation.dumpConfig) {
+      environment.stdout.write(await readFile(configPath, "utf8"));
+      return 0;
+    }
+  } catch (error) {
+    environment.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    return 2;
+  }
+
+  let harness: BootedHarness | undefined;
+  let resultCode: number | undefined;
+  let forcedExit = false;
+  const forceExit = (code: number) => {
+    if (forcedExit) return;
+    forcedExit = true;
+    environment.forceExit(code);
+  };
+  let requestedExit: ((code: number) => void) | undefined;
+  const requestedExitPromise = new Promise<number>((resolve) => {
+    requestedExit = resolve;
+  });
+  let signalledExit: ((code: number) => void) | undefined;
+  const signalPromise = new Promise<number>((resolve) => {
+    signalledExit = resolve;
+  });
+  const startupAbort = new AbortController();
+  const removeSignals = environment.onSignal((signal) => {
+    const code = signalExitCode(signal);
+    signalledExit?.(code);
+    startupAbort.abort(new Error(`Received ${signal}`));
+  });
+  try {
+    const stdio = new NodeStdio(environment.stdin, environment.stdout, environment.stderr);
+    const bootOutcome: Promise<BootOutcome> = bootHarness({
+      configPath,
+      signal: startupAbort.signal,
+      onFullReload() {
+        requestedExit?.(PI_HARNESS_RESTART_EXIT_CODE);
+      },
+      prepare(context) {
+        provideLaunchContext(context, {
+          cwd: environment.cwd,
+          agentDir: environment.agentDir,
+          args: invocation.args,
+          requestExit(code) {
+            requestedExit?.(code);
+          },
+        });
+        provideStdioContext(context, stdio);
+      },
+    }).then((booted): BootOutcome => ({ kind: "ready", harness: booted }), (error: unknown): BootOutcome => ({ kind: "error", error }));
+    const startup = await Promise.race([bootOutcome, signalPromise.then((code) => ({ kind: "signal" as const, code }))]);
+    if (startup.kind === "signal") {
+      resultCode = startup.code;
+      const settled = await settleWithin(bootOutcome, environment.shutdownTimeoutMs);
+      if (!settled.settled) {
+        forceExit(startup.code);
+        return startup.code;
+      }
+      if (settled.value.kind === "ready") harness = settled.value.harness;
+      return startup.code;
+    }
+    if (startup.kind === "error") throw startup.error;
+    harness = startup.harness;
+    const application = harness.context.get("piApplication");
+    if (application === undefined) throw new Error("Cordis profile did not provide a piApplication service");
+    const result = await Promise.race([
+      application.run().then((code) => ({ source: "application" as const, code })),
+      requestedExitPromise.then((code) => ({ source: "request" as const, code })),
+      signalPromise.then((code) => ({ source: "signal" as const, code })),
+    ]);
+    resultCode = result.code;
+    if (result.source !== "application") {
+      const runtime = harness.context.get("piRuntime");
+      if (runtime !== undefined) {
+        const aborted = await settleWithin(runtime.abort().then(() => undefined, (error: unknown) => {
+          environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+        }), environment.shutdownTimeoutMs);
+        if (!aborted.settled) forceExit(result.code);
+      }
+    }
+    return result.code;
+  } catch (error) {
+    environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+    resultCode = 1;
+    return 1;
+  } finally {
+    removeSignals();
+    if (harness !== undefined) {
+      const disposed = await settleWithin(harness.dispose().then(() => undefined, (error: unknown) => {
+        environment.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+      }), environment.shutdownTimeoutMs);
+      if (!disposed.settled) forceExit(resultCode ?? 1);
+    }
+  }
+}