@timurproko/a1-install 0.2.6 → 0.2.7-dev.1222

package/bin/a1-install.js

@@ -2,10 +2,11 @@
 
 import { spawn } from "node:child_process";
 import { access, lstat, readFile, realpath } from "node:fs/promises";
-import { lstatSync, realpathSync } from "node:fs";
+import { lstatSync, realpathSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
 import { delimiter, dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { SHARED_PROGRESS_ACCENT_ANSI } from "./progress-palette.js";
+import { SHARED_PROGRESS_ACCENT_ANSI, SHARED_PROGRESS_PALETTE } from "./progress-palette.js";
 
 export { SHARED_PROGRESS_ACCENT_ANSI };
 
@@ -26,6 +27,9 @@ const STABLE_VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$
 const DEVELOPMENT_VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)-dev\.[1-9]\d*$/u;
 const PREVIEW_NUMBER_PATTERN = /^[1-9]\d*$/u;
 const VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-dev\.[1-9]\d*)?$/u;
+const DEFAULT_REGISTRY = "https://registry.npmjs.org";
+const PACKAGE_DOCUMENT_TIMEOUT_MS = 30_000;
+const MAX_PACKAGE_DOCUMENT_BYTES = 32 * 1024 * 1024;
 
 class InstallationFailure extends Error {
   constructor(reason, details = "", exitCode = 1) {
@@ -93,12 +97,34 @@ export function installerHelp() {
   ].join("\n");
 }
 
-export function renderProgressBar(percent) {
+// Invariant: the bootstrap cannot import the main package's settings manager or its dependencies.
+// Mirror only its bounded, read-only global A1 accent resolution before acquisition.
+export function resolveInstallerAccentColor(environment = process.env, home = homedir) {
+  try {
+    const selectedHome = environment.A1_PROFILE_HOME ?? home();
+    if (!isAbsolute(selectedHome) || selectedHome.includes("\0")) return "blue";
+    const file = join(selectedHome, ".a1", "agent", "settings.json");
+    if (statSync(file).size > 256 * 1024) return "blue";
+    const raw = readFileSync(file, "utf8");
+    if (Buffer.byteLength(raw, "utf8") > 256 * 1024) return "blue";
+    const root = JSON.parse(raw.replace(/^\uFEFF/u, ""));
+    const settings = root && typeof root === "object" && !Array.isArray(root)
+      ? Object.getOwnPropertyDescriptor(root, "a1")?.value : undefined;
+    const value = settings && typeof settings === "object" && !Array.isArray(settings)
+      ? settings.accentColor : undefined;
+    if (value === "default") return "purple";
+    return typeof value === "string" && Object.hasOwn(SHARED_PROGRESS_PALETTE, value) ? value : "blue";
+  } catch {
+    return "blue";
+  }
+}
+
+export function renderProgressBar(percent, accent = SHARED_PROGRESS_ACCENT_ANSI) {
   const bounded = Math.min(100, Math.max(0, Math.round(percent)));
   const filled = Math.round((bounded / 100) * PROGRESS_WIDTH);
   const gray = "\u001b[38;2;128;128;128m";
   const track = "\u001b[38;2;102;102;102m";
-  return `${SHARED_PROGRESS_ACCENT_ANSI}${"━".repeat(filled)}${track}${"─".repeat(PROGRESS_WIDTH - filled)}${gray} ${bounded}%\u001b[39m`;
+  return `${accent}${"━".repeat(filled)}${track}${"─".repeat(PROGRESS_WIDTH - filled)}${gray} ${bounded}%\u001b[39m`;
 }
 
 export function classifyProgressLine(line, fallback = "Installing") {
@@ -150,6 +176,7 @@ class ProgressDisplay {
     this.timer = null;
     this.visible = false;
     this.maxWidth = PROGRESS_WIDTH + 6;
+    this.accent = options.accent ?? SHARED_PROGRESS_ACCENT_ANSI;
   }
 
   set(percent, _label, creepTo = percent) {
@@ -172,7 +199,7 @@ class ProgressDisplay {
     this.shown = rounded;
     if (!this.visible) this.output.write("\u001b[?25l");
     this.visible = true;
-    this.output.write(`\r${renderProgressBar(rounded)}\u001b[K`);
+    this.output.write(`\r${renderProgressBar(rounded, this.accent)}\u001b[K`);
   }
 
   finish() {
@@ -279,16 +306,49 @@ async function runChild(command, args, options) {
 
 function targetSpec(target) {
   if (target.kind === "develop") return `${APPLICATION_PACKAGE}@next`;
+  if (target.kind === "preview") return `${APPLICATION_PACKAGE}@${target.requested}`;
   return `${APPLICATION_PACKAGE}@latest`;
 }
 
+/** A numbered preview needs the registry's manifests; a full version resolves through npm directly. */
+function previewNeedsPackageDocument(target) {
+  return target.kind === "preview" && PREVIEW_NUMBER_PATTERN.test(target.requested);
+}
+
 function resolutionArguments(target) {
-  if (target.kind === "preview") {
-    return ["view", APPLICATION_PACKAGE, "versions", "--json", "--loglevel=verbose", "--no-fund", "--no-audit"];
-  }
   return ["view", targetSpec(target), "version", "--json", "--loglevel=verbose", "--no-fund", "--no-audit"];
 }
 
+function packageDocumentUrl(environment) {
+  const registry = (environment.npm_config_registry ?? "").trim() || DEFAULT_REGISTRY;
+  return `${registry.replace(/\/+$/u, "")}/${encodeURIComponent(APPLICATION_PACKAGE)}`;
+}
+
+/**
+ * The registry's full package document, whose per-version manifests record the pull request a
+ * preview was published from; the version list and the abbreviated install document do not.
+ */
+async function fetchPackageDocument(fetchImpl, environment) {
+  let response;
+  try {
+    response = await fetchImpl(packageDocumentUrl(environment), {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(PACKAGE_DOCUMENT_TIMEOUT_MS),
+    });
+  } catch (error) {
+    throw new InstallationFailure("could not resolve the selected release", String(error));
+  }
+  if (!response.ok) throw new InstallationFailure("could not resolve the selected release", `registry responded with status ${response.status}`);
+  const text = await response.text();
+  if (text.length > MAX_PACKAGE_DOCUMENT_BYTES) throw new InstallationFailure("could not resolve the selected release", "registry package document is oversized");
+  return text;
+}
+
+function recordedPullRequest(manifest) {
+  const value = manifest?.publication?.pullRequest;
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : null;
+}
+
 function updateArguments(target, targetVersion) {
   if (target.kind === "develop") return ["update", "--develop"];
   if (target.kind === "preview") return ["update", "--develop", targetVersion];
@@ -313,17 +373,32 @@ function parseResolvedVersion(stdout, target) {
   return value;
 }
 
-export function resolvePublishedPreview(stdout, requested) {
+/**
+ * The preview a `--develop` value names among the published versions: an exact full version, or a
+ * number that a manifest records as its pull request or that trails a `-dev.<number>` version
+ * published before pull requests were recorded. `source` is the registry's package document; a
+ * bare JSON list of versions is accepted as a document without records.
+ */
+export function resolvePublishedPreview(source, requested) {
   let published;
-  try { published = JSON.parse(String(stdout).trim() || "[]"); }
-  catch { throw new InstallationFailure("could not resolve the selected release", String(stdout)); }
-  const versions = (Array.isArray(published) ? published : [published])
-    .filter(value => typeof value === "string" && DEVELOPMENT_VERSION_PATTERN.test(value));
+  try { published = JSON.parse(String(source).trim() || "[]"); }
+  catch { throw new InstallationFailure("could not resolve the selected release", String(source)); }
+  const manifests = Array.isArray(published)
+    ? Object.fromEntries(published.filter(value => typeof value === "string").map(version => [version, {}]))
+    : published?.versions;
+  if (typeof manifests !== "object" || manifests === null) throw new InstallationFailure("could not resolve the selected release", String(source));
+  const previews = Object.entries(manifests)
+    .filter(([version]) => DEVELOPMENT_VERSION_PATTERN.test(version))
+    .map(([version, manifest]) => ({ version, pullRequest: recordedPullRequest(manifest) }));
+  const versions = previews.map(preview => preview.version);
   if (DEVELOPMENT_VERSION_PATTERN.test(requested)) {
     if (versions.includes(requested)) return requested;
     throw new InstallationFailure("the selected release was not found", `published no preview ${requested}`);
   }
-  const matches = versions.filter(version => version.endsWith(`-dev.${requested}`));
+  const number = Number(requested);
+  const matches = previews
+    .filter(preview => preview.pullRequest === number || preview.version.endsWith(`-dev.${requested}`))
+    .map(preview => preview.version);
   if (matches.length === 1) return matches[0];
   const detail = matches.length === 0
     ? `published no preview for ${requested}`
@@ -500,7 +575,19 @@ export async function runInstaller(argv, options = {}) {
     throw new InstallationFailure("Node.js 22.19.0 or newer is required");
   }
 
-  const progress = options.progress ?? new ProgressDisplay(stdout, options.tty ?? stdout.isTTY === true, options.progressOptions);
+  const accentColor = resolveInstallerAccentColor(environment);
+  const background = Number.parseInt(String(environment.COLORFGBG ?? "").split(";").at(-1) ?? "", 10);
+  const appearance = Number.isInteger(background) && (background === 7 || background === 15 || background >= 231) ? "light" : "dark";
+  const program = (environment.TERM_PROGRAM ?? "").toLowerCase();
+  const known = ["kitty", "ghostty", "wezterm", "rex", "warpterminal", "iterm.app", "alacritty", "vscode", "zed"];
+  const trueColor = environment.PI_TRUE_COLOR === "1" || (environment.PI_TRUE_COLOR !== "0" && (
+    /^(truecolor|24bit)$/iu.test(environment.COLORTERM ?? "")
+    || (environment.TERM ?? "").endsWith("-direct") || process.platform === "win32"
+    || environment.WT_SESSION !== undefined || known.includes(program)
+  ));
+  const mode = trueColor ? "truecolor" : "256color";
+  const accent = SHARED_PROGRESS_PALETTE[accentColor][appearance][mode].accent;
+  const progress = options.progress ?? new ProgressDisplay(stdout, options.tty ?? stdout.isTTY === true, { ...options.progressOptions, accent });
   const runner = options.runner ?? createDefaultProcessRunner(environment);
   let activeChild = null;
   let killTimer = null;
@@ -532,16 +619,23 @@ export async function runInstaller(argv, options = {}) {
   try {
     progress.set(3, "Preparing", 10);
     let phase = "Resolving version";
-    const resolveResult = await runner.npm(resolutionArguments(parsed.target), {
-      onChild: setActiveChild,
-      onStderrLine: line => { phase = classifyProgressLine(line, phase); progress.set(10, phase, 18); },
-    });
-    setActiveChild(null);
-    if (cancelled) throw new InstallationCancelled();
-    if (resolveResult.code !== 0) throw new InstallationFailure(conciseFailure("resolve", resolveResult.stderr), resolveResult.stderr);
-    const targetVersion = parsed.target.kind === "preview"
-      ? resolvePublishedPreview(resolveResult.stdout, parsed.target.requested)
-      : parseResolvedVersion(resolveResult.stdout, parsed.target);
+    let targetVersion;
+    if (previewNeedsPackageDocument(parsed.target)) {
+      // Rationale: a numbered preview is found by the pull request its published manifest records,
+      // which only the registry's full package document carries.
+      const document = await fetchPackageDocument(options.fetch ?? globalThis.fetch, environment);
+      if (cancelled) throw new InstallationCancelled();
+      targetVersion = resolvePublishedPreview(document, parsed.target.requested);
+    } else {
+      const resolveResult = await runner.npm(resolutionArguments(parsed.target), {
+        onChild: setActiveChild,
+        onStderrLine: line => { phase = classifyProgressLine(line, phase); progress.set(10, phase, 18); },
+      });
+      setActiveChild(null);
+      if (cancelled) throw new InstallationCancelled();
+      if (resolveResult.code !== 0) throw new InstallationFailure(conciseFailure("resolve", resolveResult.stderr), resolveResult.stderr);
+      targetVersion = parseResolvedVersion(resolveResult.stdout, parsed.target);
+    }
     progress.set(18, "Resolving packages", 24);
 
     const rootResult = await runner.npm(["root", "--global", "--loglevel=error", "--no-fund", "--no-audit"], { onChild: setActiveChild });

package/bin/progress-palette.js

@@ -1,5 +1,139 @@
 /**
- * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.1.0
- * (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7. Do not edit directly.
+ * Generated by scripts/pi/sync-progress-palette.ts from A1's named accent projection
+ * over pinned Pi 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0. Do not edit directly.
  */
-export const SHARED_PROGRESS_ACCENT_ANSI = "\u001b[38;2;167;152;215m";
+export const SHARED_PROGRESS_PALETTE = Object.freeze({
+  "blue": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;130;160;241m",
+        "border": "\u001b[38;2;116;102;197m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;111m",
+        "border": "\u001b[38;5;98m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;63;96;226m",
+        "border": "\u001b[38;2;83;67;154m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;62m",
+        "border": "\u001b[38;5;60m"
+      }
+    }
+  },
+  "purple": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;167;152;215m",
+        "border": "\u001b[38;2;105;115;167m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;140m",
+        "border": "\u001b[38;5;61m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;116;89;180m",
+        "border": "\u001b[38;2;68;77;130m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;97m",
+        "border": "\u001b[38;5;60m"
+      }
+    }
+  },
+  "cyan": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;93;179;186m",
+        "border": "\u001b[38;2;74;128;146m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;73m",
+        "border": "\u001b[38;5;66m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;40;122;129m",
+        "border": "\u001b[38;2;40;89;106m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;30m",
+        "border": "\u001b[38;5;23m"
+      }
+    }
+  },
+  "green": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;104;183;141m",
+        "border": "\u001b[38;2;75;132;120m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;72m",
+        "border": "\u001b[38;5;66m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;51;126;88m",
+        "border": "\u001b[38;2;41;93;82m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;65m",
+        "border": "\u001b[38;5;23m"
+      }
+    }
+  },
+  "orange": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;231;135;83m",
+        "border": "\u001b[38;2;178;89;79m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;173m",
+        "border": "\u001b[38;5;131m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;174;80;16m",
+        "border": "\u001b[38;2;133;57;49m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;130m",
+        "border": "\u001b[38;5;95m"
+      }
+    }
+  },
+  "pink": {
+    "dark": {
+      "truecolor": {
+        "accent": "\u001b[38;2;223;122;199m",
+        "border": "\u001b[38;2;150;91;171m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;176m",
+        "border": "\u001b[38;5;97m"
+      }
+    },
+    "light": {
+      "truecolor": {
+        "accent": "\u001b[38;2;178;56;153m",
+        "border": "\u001b[38;2;114;61;131m"
+      },
+      "256color": {
+        "accent": "\u001b[38;5;132m",
+        "border": "\u001b[38;5;60m"
+      }
+    }
+  }
+});
+export const SHARED_PROGRESS_ACCENT_ANSI = SHARED_PROGRESS_PALETTE.blue.dark.truecolor.accent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1-install",
-  "version": "0.2.6",
+  "version": "0.2.7-dev.1222",
   "description": "Dependency-free installer for a1",
   "type": "module",
   "bin": {
@@ -23,5 +23,9 @@
     "url": "https://github.com/timurproko/a1"
   },
   "author": "Timur Prokopiev",
-  "license": "MIT"
+  "license": "MIT",
+  "publication": {
+    "source": "0ec0a4fd915c5e452ca135159dcb58e810dea96f",
+    "pullRequest": 847
+  }
 }