agentel 0.2.8 → 0.3.0

package/scripts/postinstall.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { spawnSync } = require("child_process");
+const { paths } = require("../src/paths");
+
+const PACKAGE_NAMES = new Set(["agentel", "agentlog"]);
+
+async function main(env = process.env, io = process) {
+  const plan = buildPostinstallPlan(env, {
+    stdinIsTTY: Boolean(io.stdin?.isTTY),
+    stdoutIsTTY: Boolean(io.stdout?.isTTY)
+  });
+
+  if (plan.skip) return;
+
+  if (!plan.interactive) {
+    printPostinstallHint(plan);
+    return;
+  }
+
+  const answer = await ask(plan.prompt, io);
+  if (!isYes(answer)) {
+    console.log(`Skipped. Run \`${plan.displayCommand}\` when you are ready.`);
+    return;
+  }
+
+  const result = spawnSync(process.execPath, [agentlogBin(), plan.command], {
+    stdio: "inherit",
+    env
+  });
+  if (result.error) throw result.error;
+  if (result.status !== 0) process.exitCode = result.status || 1;
+}
+
+function buildPostinstallPlan(env = process.env, options = {}) {
+  if (isTruthy(env.AGENTLOG_SKIP_POSTINSTALL)) return skipped("AGENTLOG_SKIP_POSTINSTALL is set");
+  if (isTruthy(env.CI)) return skipped("CI is set");
+  if (env.npm_command === "exec") return skipped("npm exec/npx install");
+  if (env.npm_lifecycle_event && env.npm_lifecycle_event !== "postinstall") {
+    return skipped("not a postinstall lifecycle");
+  }
+  if (!isUserRequestedInstall(env)) return skipped("not a direct agentlog install");
+
+  const configured = fs.existsSync(paths(env).config);
+  const command = configured ? "update" : "init";
+  const displayCommand = `agentlog ${command}`;
+  const commandOnPath = findCommandOnPath("agentlog", env);
+  const pathNote = commandOnPath
+    ? ""
+    : "The installed command is not on PATH in this shell yet, so this prompt will run the packaged CLI directly.";
+  const intro = configured
+    ? `Found an existing agentlog config. Run \`${displayCommand}\` now to refresh this archive for the installed version?`
+    : `No agentlog config found. Run \`${displayCommand}\` now to set up local archiving?`;
+
+  return {
+    skip: false,
+    command,
+    configured,
+    displayCommand,
+    commandOnPath,
+    interactive: Boolean(options.stdinIsTTY && options.stdoutIsTTY),
+    prompt: `${intro}${pathNote ? `\n${pathNote}` : ""}\nRun now? [y/N] `
+  };
+}
+
+function isUserRequestedInstall(env) {
+  if (isTruthy(env.AGENTLOG_POSTINSTALL_FORCE)) return true;
+  if (env.npm_config_global === "true" || env.npm_config_location === "global") return true;
+  const initCwd = env.INIT_CWD ? path.resolve(env.INIT_CWD) : "";
+  const packageRoot = path.resolve(__dirname, "..");
+  if (!initCwd || initCwd === packageRoot) return false;
+  return projectDependsOnAgentlog(initCwd);
+}
+
+function projectDependsOnAgentlog(projectDir) {
+  const packageJson = readJson(path.join(projectDir, "package.json"));
+  if (!packageJson) return false;
+  for (const section of ["dependencies", "devDependencies", "optionalDependencies"]) {
+    const deps = packageJson[section] || {};
+    for (const name of PACKAGE_NAMES) {
+      if (Object.prototype.hasOwnProperty.call(deps, name)) return true;
+    }
+  }
+  return false;
+}
+
+function printPostinstallHint(plan) {
+  console.log(`agentlog installed. Run \`${plan.displayCommand}\` to ${plan.configured ? "refresh your archive" : "set up local archiving"}.`);
+}
+
+function ask(prompt, io = process) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: io.stdin, output: io.stdout });
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
+function findCommandOnPath(command, env = process.env) {
+  const pathValue = env.PATH || env.Path || env.path || "";
+  const pathExt = process.platform === "win32"
+    ? String(env.PATHEXT || ".EXE;.CMD;.BAT;.COM").split(";").filter(Boolean)
+    : [""];
+  for (const dir of pathValue.split(path.delimiter).filter(Boolean)) {
+    for (const ext of pathExt) {
+      const candidate = path.join(dir, `${command}${ext}`);
+      if (fs.existsSync(candidate)) return candidate;
+    }
+  }
+  return "";
+}
+
+function agentlogBin() {
+  return path.resolve(__dirname, "..", "bin", "agentlog.js");
+}
+
+function isYes(value) {
+  return /^(y|yes)$/i.test(String(value || "").trim());
+}
+
+function isTruthy(value) {
+  return ["1", "true", "yes", "on"].includes(String(value || "").trim().toLowerCase());
+}
+
+function readJson(file) {
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    return null;
+  }
+}
+
+function skipped(reason) {
+  return { skip: true, reason };
+}
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error(error?.message || String(error));
+    process.exitCode = 1;
+  });
+}
+
+module.exports = {
+  buildPostinstallPlan,
+  isYes,
+  isUserRequestedInstall,
+  projectDependsOnAgentlog
+};