pi-app 0.7.6 → 0.8.0

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":29549708,"timestamp":93152510,"id":14,"parentId":1,"tags":{},"startTime":1781179315316,"traceId":"1232ccadb30f6e97"},{"name":"run-typescript","duration":9259082,"timestamp":122706335,"id":8604,"parentId":1,"tags":{},"startTime":1781179344870,"traceId":"1232ccadb30f6e97"},{"name":"static-check","duration":1911797,"timestamp":132034473,"id":8607,"parentId":1,"tags":{},"startTime":1781179354198,"traceId":"1232ccadb30f6e97"},{"name":"static-generation","duration":5711903,"timestamp":134429306,"id":8723,"parentId":1,"tags":{},"startTime":1781179356593,"traceId":"1232ccadb30f6e97"},{"name":"collect-build-traces","duration":43009643,"timestamp":133948727,"id":8720,"parentId":1,"tags":{},"startTime":1781179356112,"traceId":"1232ccadb30f6e97"},{"name":"telemetry-flush","duration":56,"timestamp":176962689,"id":8732,"parentId":1,"tags":{},"startTime":1781179399126,"traceId":"1232ccadb30f6e97"},{"name":"next-build","duration":83965833,"timestamp":92996925,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1781179315160,"traceId":"1232ccadb30f6e97"}]
+[{"name":"run-webpack","duration":28222545,"timestamp":156175997,"id":14,"parentId":1,"tags":{},"startTime":1781182004326,"traceId":"9491902b6c19c8a7"},{"name":"run-typescript","duration":9148112,"timestamp":184402807,"id":8604,"parentId":1,"tags":{},"startTime":1781182032553,"traceId":"9491902b6c19c8a7"},{"name":"static-check","duration":1995937,"timestamp":193610107,"id":8607,"parentId":1,"tags":{},"startTime":1781182041760,"traceId":"9491902b6c19c8a7"},{"name":"static-generation","duration":5157335,"timestamp":196103481,"id":8723,"parentId":1,"tags":{},"startTime":1781182044254,"traceId":"9491902b6c19c8a7"},{"name":"collect-build-traces","duration":43466334,"timestamp":195613027,"id":8720,"parentId":1,"tags":{},"startTime":1781182043763,"traceId":"9491902b6c19c8a7"},{"name":"telemetry-flush","duration":50,"timestamp":239082431,"id":8732,"parentId":1,"tags":{},"startTime":1781182087233,"traceId":"9491902b6c19c8a7"},{"name":"next-build","duration":83045692,"timestamp":156036801,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1781182004187,"traceId":"9491902b6c19c8a7"}]

package/README.md

@@ -19,6 +19,21 @@ pi-app
 
 启动后打开 [http://localhost:30141](http://localhost:30141)。
 
+**一并提供 `pi` 命令行：**
+
+全局安装 pi-app 时会顺带提供 `pi` 命令（即 pi 编程智能体 CLI，与 pi-app 内置版本一致），无需单独安装：
+
+```bash
+npm install -g pi-app
+pi --help        # 直接使用 pi CLI
+```
+
+行为说明：
+
+- 安装后仅当系统中**尚未存在** `pi` 命令时，才会创建 `pi`（一个转发到 pi-app 内置 CLI 的独立 shim）。
+- 若你已单独安装过 `pi`（如通过 `npm i -g @earendil-works/pi-coding-agent` 或 Homebrew），则**保留你已有的版本，不会覆盖**。
+- 卸载说明：npm **不会**执行卸载钩子（`postuninstall`），因此 `npm uninstall -g pi-app` 后这个 `pi` shim 会残留。它是独立 shim 而非失效软链——此时运行 `pi` 不会报「文件不存在」，而是友好提示你重新安装 pi-app 或删除该文件（提示里会给出确切路径）。如需立即清理，按提示删除该 `pi` 文件即可（不会影响你自行安装的其他 `pi`）。
+
 **可选参数：**
 
 ```bash

package/bin/pi.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+"use strict";
+
+// Thin launcher that forwards to the pi coding-agent CLI bundled with pi-app.
+// Installed (symlinked / shimmed) as the global `pi` command by
+// scripts/install-cli.mjs, but ONLY when no `pi` already exists on the system.
+//
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const path = require("path");
+
+let cliPath;
+try {
+  cliPath = require.resolve("@earendil-works/pi-coding-agent/dist/cli.js");
+} catch {
+  // Fallback to the package-local node_modules layout if resolution fails.
+  cliPath = path.join(
+    __dirname,
+    "..",
+    "node_modules",
+    "@earendil-works",
+    "pi-coding-agent",
+    "dist",
+    "cli.js",
+  );
+}
+
+// cli.js reads process.argv.slice(2) itself; requiring it runs the CLI.
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+require(cliPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-app",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "description": "Web UI for the pi coding agent",
   "license": "MIT",
   "homepage": "https://github.com/asiachrispy/pi-app",
@@ -16,6 +16,9 @@
   },
   "files": [
     "bin",
+    "scripts/install-cli.mjs",
+    "scripts/uninstall-cli.mjs",
+    "scripts/cli-link-common.mjs",
     ".next",
     "!.next/cache",
     "!.next/dev",
@@ -36,6 +39,8 @@
     "test:m2": "node scripts/m2-preflight.mjs",
     "test:m3": "node scripts/m3-preflight.mjs",
     "test:m4": "node scripts/m4-preflight.mjs",
+    "postinstall": "node scripts/install-cli.mjs",
+    "postuninstall": "node scripts/uninstall-cli.mjs",
     "package:macos": "bash scripts/package-macos-app.sh",
     "tunnel:cloudflare": "bash scripts/tunnel-cloudflared.sh",
     "relay:server": "node --experimental-strip-types scripts/pi-relay-server.ts",

package/scripts/cli-link-common.mjs

@@ -0,0 +1,110 @@
+// Shared helpers for installing/uninstalling the global `pi` command that
+// forwards to the pi coding-agent CLI bundled with pi-app.
+//
+// Design notes:
+// - We deliberately do NOT declare `bin.pi` in package.json. npm refuses to
+//   overwrite a global bin owned by another package (EEXIST) and would make
+//   `npm i -g pi-app` fail outright when the user already has `pi` installed.
+// - Instead postinstall conditionally creates the link only when no `pi`
+//   exists, and removes it only if we are the ones who made it.
+// - The global `pi` is a STANDALONE shim (not a symlink into the package).
+//   npm does not run uninstall lifecycle scripts (postuninstall), so after
+//   `npm uninstall -g pi-app` the shim would otherwise dangle. A standalone
+//   shim degrades gracefully: running `pi` then prints how to reinstall/remove
+//   instead of failing with a confusing "no such file" error.
+
+import { execFileSync } from "node:child_process";
+import { chmodSync, lstatSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const isWindows = process.platform === "win32";
+
+/** Marker embedded in every shim we generate, used to detect ownership. */
+export const SHIM_MARKER = "pi-app-managed-cli";
+
+const here = dirname(fileURLToPath(import.meta.url));
+
+/** pi-app package root (the dir containing package.json). */
+export function getPkgRoot() {
+  return resolve(here, "..");
+}
+
+/** Absolute path to the launcher the shim forwards to. */
+export function getLauncherPath() {
+  return join(getPkgRoot(), "bin", "pi.js");
+}
+
+/** True when npm is running this lifecycle script for a global install. */
+export function isGlobalInstall() {
+  return process.env.npm_config_global === "true";
+}
+
+/**
+ * Resolve the directory npm links global bins into.
+ * Unix: <prefix>/bin. Windows: <prefix> itself.
+ */
+export function getGlobalBinDir() {
+  const prefix = process.env.npm_config_prefix;
+  if (prefix) return isWindows ? prefix : join(prefix, "bin");
+
+  // Fallback: derive from the install location of this package.
+  // Unix:    <prefix>/lib/node_modules/pi-app
+  // Windows: <prefix>/node_modules/pi-app
+  const pkgRoot = getPkgRoot();
+  return isWindows
+    ? resolve(pkgRoot, "..", "..")
+    : resolve(pkgRoot, "..", "..", "..", "bin");
+}
+
+/** Path of the global command file we manage. */
+export function getLinkPath(binDir) {
+  return join(binDir, isWindows ? "pi.cmd" : "pi");
+}
+
+/** Whether an existing global `pi` is a shim created by us (safe to manage). */
+export function shimIsOurs(linkPath) {
+  try {
+    return readFileSync(linkPath, "utf8").includes(SHIM_MARKER);
+  } catch {
+    return false;
+  }
+}
+
+/** True if some `pi` command is already resolvable on PATH. */
+export function piExistsOnPath() {
+  const finder = isWindows ? "where" : "which";
+  try {
+    execFileSync(finder, ["pi"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Best-effort detection of "something already occupies this path". */
+export function pathOccupied(linkPath) {
+  try {
+    lstatSync(linkPath); // lstat so broken symlinks count as occupied too
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function makeExecutable(file) {
+  if (isWindows) return;
+  try {
+    chmodSync(file, 0o755);
+  } catch {
+    // best effort
+  }
+}
+
+const TAG = "[pi-app] ";
+export function log(msg) {
+  process.stdout.write(`${TAG}${msg}\n`);
+}
+export function warn(msg) {
+  process.stderr.write(`${TAG}${msg}\n`);
+}

package/scripts/install-cli.mjs

@@ -0,0 +1,108 @@
+// postinstall: make `pi` available globally when (and only when) the user
+// doesn't already have a `pi` command. Never fails the install.
+
+import { mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import {
+  getGlobalBinDir,
+  getLauncherPath,
+  getLinkPath,
+  isGlobalInstall,
+  isWindows,
+  log,
+  makeExecutable,
+  pathOccupied,
+  piExistsOnPath,
+  SHIM_MARKER,
+  shimIsOurs,
+  warn,
+} from "./cli-link-common.mjs";
+
+// A standalone shim (not a symlink into the package). It forwards to the
+// bundled launcher, and—because npm doesn't run postuninstall—degrades
+// gracefully if pi-app is later removed.
+function shimContents(launcher) {
+  if (isWindows) {
+    const q = `"${launcher}"`;
+    return [
+      "@ECHO off",
+      `REM ${SHIM_MARKER} (do not edit) - forwards to the pi CLI bundled with pi-app`,
+      `IF EXIST ${q} (`,
+      `  node ${q} %*`,
+      ") ELSE (",
+      "  echo pi: this command is provided by pi-app, which is no longer installed. Reinstall: npm i -g pi-app 1>&2",
+      "  EXIT /B 127",
+      ")",
+      "",
+    ].join("\r\n");
+  }
+  return [
+    "#!/usr/bin/env node",
+    `// ${SHIM_MARKER} (do not edit) - forwards to the pi CLI bundled with pi-app`,
+    '"use strict";',
+    'const fs = require("fs");',
+    `const launcher = ${JSON.stringify(launcher)};`,
+    "if (!fs.existsSync(launcher)) {",
+    '  process.stderr.write("pi: this command is provided by pi-app, which is no longer installed.\\n");',
+    '  process.stderr.write("Reinstall with: npm i -g pi-app  (or delete this file: " + process.argv[1] + ")\\n");',
+    "  process.exit(127);",
+    "}",
+    "require(launcher);",
+    "",
+  ].join("\n");
+}
+
+function createShim(linkPath, launcher) {
+  // npm runs postinstall BEFORE it creates the global bin dir and links bins,
+  // so on a fresh prefix this dir may not exist yet.
+  mkdirSync(dirname(linkPath), { recursive: true });
+  writeFileSync(linkPath, shimContents(launcher), "utf8");
+  makeExecutable(linkPath);
+}
+
+function main() {
+  if (!isGlobalInstall()) return; // only relevant for `npm i -g pi-app`
+
+  const launcher = getLauncherPath();
+  if (!pathOccupied(launcher)) {
+    warn(`launcher not found at ${launcher}; skipping pi CLI setup.`);
+    return;
+  }
+
+  const binDir = getGlobalBinDir();
+  const linkPath = getLinkPath(binDir);
+
+  // Already our shim from a previous install — refresh it (e.g. path changes).
+  if (shimIsOurs(linkPath)) {
+    try {
+      unlinkSync(linkPath);
+    } catch {
+      // ignore; createShim overwrites anyway
+    }
+    createShim(linkPath, launcher);
+    log(`pi CLI refreshed -> ${linkPath}`);
+    return;
+  }
+
+  // Something else owns this path — keep it, don't clobber.
+  if (pathOccupied(linkPath)) {
+    log(`existing pi found at ${linkPath}; keeping it (not overwriting).`);
+    return;
+  }
+
+  // A pi exists elsewhere on PATH (e.g. Homebrew, a separate global install).
+  if (piExistsOnPath()) {
+    log("an existing pi command was found on PATH; keeping it.");
+    return;
+  }
+
+  createShim(linkPath, launcher);
+  log(`pi CLI installed -> ${linkPath}`);
+}
+
+try {
+  main();
+} catch (err) {
+  // postinstall must never break `npm i -g pi-app`.
+  warn(`could not set up the pi CLI automatically: ${err?.message ?? err}`);
+}

package/scripts/uninstall-cli.mjs

@@ -0,0 +1,35 @@
+// postuninstall: remove the global `pi` shim ONLY if we created it.
+//
+// NOTE: npm does NOT run uninstall lifecycle scripts, so this will typically
+// NOT execute on `npm uninstall -g pi-app`. It is kept as best-effort for
+// package managers that do honor it (and manual invocation). When it doesn't
+// run, the standalone shim degrades gracefully instead of dangling. Never
+// fails the uninstall.
+
+import { unlinkSync } from "node:fs";
+import {
+  getGlobalBinDir,
+  getLinkPath,
+  isGlobalInstall,
+  log,
+  shimIsOurs,
+  warn,
+} from "./cli-link-common.mjs";
+
+function main() {
+  if (!isGlobalInstall()) return;
+
+  const binDir = getGlobalBinDir();
+  const linkPath = getLinkPath(binDir);
+
+  if (!shimIsOurs(linkPath)) return; // not ours — leave it alone
+
+  unlinkSync(linkPath);
+  log(`removed pi CLI shim at ${linkPath}`);
+}
+
+try {
+  main();
+} catch (err) {
+  warn(`could not clean up the pi CLI shim: ${err?.message ?? err}`);
+}