terminal-pilot 0.0.7 → 0.0.9

package/dist/cli.js

@@ -1655,8 +1655,8 @@ function findVisibleChild(group, token, scope) {
     (child) => child.name === token || child.aliases.includes(token)
   );
 }
-function resolveHelpTarget(root, argv, scope) {
-  const breadcrumb = [root.name];
+function resolveHelpTarget(root, argv, scope, rootDisplayName) {
+  const breadcrumb = [rootDisplayName ?? root.name];
   let current = root;
   for (const token of argv.slice(2)) {
     if (token.startsWith("-") || token === "help") {
@@ -1747,7 +1747,7 @@ function formatCommandRows(group, scope) {
 function formatGlobalOptionRows(showVersion) {
   const rows = [
     {
-      flags: "--preset",
+      flags: "--preset <path>",
       description: "Load parameter defaults from a JSON file"
     },
     {
@@ -1755,11 +1755,11 @@ function formatGlobalOptionRows(showVersion) {
       description: "Accept defaults, skip prompts"
     },
     {
-      flags: "--output",
+      flags: "--output <format>",
       description: "Output format (rich, md, json)"
     },
     {
-      flags: "--help",
+      flags: "-h, --help",
       description: "Show help"
     }
   ];
@@ -1774,7 +1774,14 @@ function formatGlobalOptionRows(showVersion) {
 function renderHelpSections(sections) {
   return sections.filter((section) => section.length > 0).join("\n\n");
 }
-function renderGroupHelp(group, breadcrumb, scope, showVersion) {
+function buildUsageLine(breadcrumb, rootUsageName, suffix) {
+  if (rootUsageName === void 0) {
+    return void 0;
+  }
+  const subPath = breadcrumb.slice(1).join(" ");
+  return subPath ? `${rootUsageName} ${subPath} ${suffix}` : `${rootUsageName} ${suffix}`;
+}
+function renderGroupHelp(group, breadcrumb, scope, showVersion, rootUsageName) {
   const sections = [];
   const commandRows = formatCommandRows(group, scope);
   if (commandRows.length > 0) {
@@ -1785,12 +1792,13 @@ ${formatCommandList(commandRows)}`);
 ${formatOptionList(formatGlobalOptionRows(showVersion))}`);
   return renderHelpDocument({
     breadcrumb,
+    usageLine: buildUsageLine(breadcrumb, rootUsageName, "[options] [command]"),
     description: group.description,
     requiresAuth: group.requires?.auth === true,
     sections
   });
 }
-function renderLeafHelp(command, breadcrumb, casing) {
+function renderLeafHelp(command, breadcrumb, casing, rootUsageName) {
   const sections = [];
   const fields = assignPositionals(collectFields(command.params, casing), command.positional);
   const optionRows = fields.map((field) => ({
@@ -1808,8 +1816,11 @@ ${formatOptionList(formatGlobalOptionRows(false))}`);
     sections.push(`${text.section("Secrets (via environment):")}
 ${formatOptionList(secretRows)}`);
   }
+  const positionalFields = fields.filter((f) => f.positionalIndex !== void 0);
+  const usageSuffix = positionalFields.length > 0 ? `[options] ${positionalFields.map(formatPositionalToken).join(" ")}` : "[options]";
   return renderHelpDocument({
     breadcrumb,
+    usageLine: buildUsageLine(breadcrumb, rootUsageName, usageSuffix),
     description: command.description,
     requiresAuth: command.requires?.auth === true,
     sections
@@ -1817,11 +1828,14 @@ ${formatOptionList(secretRows)}`);
 }
 function renderHelpDocument(input) {
   const lines = [text.heading(input.breadcrumb.join(" ")), ""];
+  if (input.usageLine !== void 0) {
+    lines.push(`${text.section("Usage:")} ${text.usageCommand(input.usageLine)}`, "");
+  }
   if (input.description !== void 0) {
-    lines.push(`  ${input.description}`);
+    lines.push(input.description);
   }
   if (input.requiresAuth) {
-    lines.push("  Requires: authentication");
+    lines.push("Requires: authentication");
   }
   if (input.description !== void 0 || input.requiresAuth) {
     lines.push("");
@@ -1831,11 +1845,11 @@ function renderHelpDocument(input) {
 `;
 }
 async function renderGeneratedHelp(root, argv, options) {
-  const target = resolveHelpTarget(root, argv, "cli");
+  const target = resolveHelpTarget(root, argv, "cli", options.rootDisplayName);
   const output = resolveHelpOutput(argv);
   const casing = options.casing ?? "kebab";
   await withOutputFormat2(output, async () => {
-    const rendered = target.node.kind === "group" ? renderGroupHelp(target.node, target.breadcrumb, "cli", options.version !== void 0) : renderLeafHelp(target.node, target.breadcrumb, casing);
+    const rendered = target.node.kind === "group" ? renderGroupHelp(target.node, target.breadcrumb, "cli", options.version !== void 0, options.rootUsageName) : renderLeafHelp(target.node, target.breadcrumb, casing, options.rootUsageName);
     process.stdout.write(rendered);
   });
 }
@@ -2605,8 +2619,10 @@ async function runCLI(roots, options = {}) {
 import { randomUUID } from "node:crypto";
 
 // src/terminal-session.ts
-import { spawn as spawnChildProcess } from "node:child_process";
 import { EventEmitter } from "node:events";
+import { accessSync, chmodSync, constants } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
 import * as nodePty from "node-pty";
 
 // src/ansi.ts
@@ -3517,93 +3533,43 @@ function createPtyProcess({
   cols,
   rows
 }) {
-  try {
-    return nodePty.spawn(command, args, {
-      cwd,
-      env,
-      cols,
-      rows,
-      encoding: "utf8"
-    });
-  } catch {
-    return createChildProcessFallback({ command, args, cwd, env });
-  }
-}
-function createChildProcessFallback({
-  command,
-  args,
-  cwd,
-  env
-}) {
-  const child = spawnChildProcess(command, args, {
+  ensureSpawnHelperExecutable();
+  return nodePty.spawn(command, args, {
     cwd,
     env,
-    stdio: ["pipe", "pipe", "pipe"]
+    cols,
+    rows,
+    encoding: "utf8"
   });
-  return new ChildProcessFallback(child);
 }
-var ChildProcessFallback = class {
-  pid;
-  child;
-  dataEmitter = new EventEmitter();
-  exitEmitter = new EventEmitter();
-  constructor(child) {
-    this.child = child;
-    this.pid = child.pid ?? -1;
-    child.stdout.setEncoding("utf8");
-    child.stderr.setEncoding("utf8");
-    child.stdout.on("data", this.handleData);
-    child.stderr.on("data", this.handleData);
-    child.on("exit", (exitCode, signal) => {
-      this.exitEmitter.emit("exit", {
-        exitCode: exitCode ?? signalToExitCode(signal),
-        signal: void 0
-      });
-    });
-  }
-  write(data) {
-    this.child.stdin.write(data);
-  }
-  resize() {
-  }
-  kill(signal) {
-    this.child.kill(signal);
-  }
-  onData(listener) {
-    this.dataEmitter.on("data", listener);
-    return {
-      dispose: () => {
-        this.dataEmitter.off("data", listener);
-      }
-    };
-  }
-  onExit(listener) {
-    this.exitEmitter.on("exit", listener);
-    return {
-      dispose: () => {
-        this.exitEmitter.off("exit", listener);
+var spawnHelperChecked = false;
+function ensureSpawnHelperExecutable() {
+  if (spawnHelperChecked) return;
+  spawnHelperChecked = true;
+  const require3 = createRequire(import.meta.url);
+  const nodePtyDir = dirname(require3.resolve("node-pty"));
+  const helper = join(nodePtyDir, "..", "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+  try {
+    accessSync(helper, constants.X_OK);
+  } catch (error2) {
+    if (isMissingFileError(error2)) {
+      return;
+    }
+    try {
+      chmodSync(helper, 493);
+    } catch (chmodError) {
+      if (isMissingFileError(chmodError)) {
+        return;
       }
-    };
-  }
-  handleData = (chunk) => {
-    this.dataEmitter.emit("data", String(chunk));
-  };
-};
-function signalToExitCode(signal) {
-  if (signal === null) {
-    return 0;
+      throw chmodError;
+    }
   }
-  const signalNumbers = {
-    SIGTERM: 15,
-    SIGINT: 2,
-    SIGHUP: 1,
-    SIGKILL: 9
-  };
-  const signalNumber = signalNumbers[signal];
-  if (signalNumber === void 0) {
-    return 1;
+}
+function isMissingFileError(error2) {
+  if (!(error2 instanceof Error)) {
+    return false;
   }
-  return 128 + signalNumber;
+  return "code" in error2 && error2.code === "ENOENT";
 }
 function matchPattern(buffer, pattern) {
   const clean = normalizeHistoryBuffer(stripAnsi2(buffer));
@@ -4983,9 +4949,6 @@ async function executeMutation(mutation, context, options) {
 import Mustache2 from "mustache";
 var originalEscape = Mustache2.escape;
 
-// ../agent-skill-config/src/templates.ts
-import { readFile as readFile2 } from "node:fs/promises";
-
 // ../agent-skill-config/src/apply.ts
 var UnsupportedAgentError = class extends Error {
   constructor(agentId) {
@@ -5044,7 +5007,7 @@ async function installSkill(agentId, skill, options) {
 import os2 from "node:os";
 import path4 from "node:path";
 import * as nodeFs from "node:fs/promises";
-import { readFile as readFile3 } from "node:fs/promises";
+import { readFile as readFile2 } from "node:fs/promises";
 var DEFAULT_INSTALL_AGENT = "claude-code";
 var DEFAULT_INSTALL_SCOPE = "local";
 var TERMINAL_PILOT_SKILL_NAME = "terminal-pilot";
@@ -5094,7 +5057,7 @@ async function loadTerminalPilotTemplate() {
   ];
   for (const candidate of candidates) {
     try {
-      terminalPilotTemplateCache = await readFile3(candidate, "utf8");
+      terminalPilotTemplateCache = await readFile2(candidate, "utf8");
       return terminalPilotTemplateCache;
     } catch (error2) {
       if (!isNotFoundError(error2)) {
@@ -5529,14 +5492,14 @@ import { Resvg } from "@resvg/resvg-js";
 
 // ../terminal-png/src/font.ts
 import { readFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
+import { createRequire as createRequire2 } from "node:module";
+import { dirname as dirname2, join as join2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-var require2 = createRequire(import.meta.url);
-var fontPackageRoot = dirname(require2.resolve("jetbrains-mono/package.json"));
-var webfontRoot = join(fontPackageRoot, "fonts/webfonts");
+var require2 = createRequire2(import.meta.url);
+var fontPackageRoot = dirname2(require2.resolve("jetbrains-mono/package.json"));
+var webfontRoot = join2(fontPackageRoot, "fonts/webfonts");
 function readWebfontBase64(filename) {
-  return readFileSync(join(webfontRoot, filename)).toString("base64");
+  return readFileSync(join2(webfontRoot, filename)).toString("base64");
 }
 function resolveAssetPath(filename) {
   return fileURLToPath2(new URL(`../assets/${filename}`, import.meta.url));