@aexol/spectral 0.9.133 → 0.9.134

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.133",
+  "version": "0.9.134",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,
@@ -20,6 +20,7 @@
   },
   "files": [
     "dist",
+    "scripts/postinstall.mjs",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -33,7 +34,12 @@
     "build:standalone": "bash scripts/build-standalone.sh",
     "build:standalone:all": "bash scripts/build-standalone.sh --all",
     "build:electron": "bash scripts/build-electron.sh",
-    "build:electron:all": "bash scripts/build-electron.sh --all"
+    "build:electron:all": "bash scripts/build-electron.sh --all",
+    "postinstall": "node scripts/postinstall.mjs"
+  },
+  "overrides": {
+    "glob": "^13.0.0",
+    "encoding-sniffer": "^1.0.0"
   },
   "engines": {
     "node": ">=20"
@@ -80,7 +86,7 @@
     "cross-spawn": "^7.0.6",
     "diff": "^8.0.0",
     "get-east-asian-width": "^1.3.0",
-    "glob": "^11.0.0",
+    "glob": "^13.0.0",
     "highlight.js": "^11.11.0",
     "hosted-git-info": "^8.0.0",
     "ignore": "^7.0.0",

package/scripts/postinstall.mjs

@@ -0,0 +1,186 @@
+/**
+ * @aexol/spectral — postinstall welcome message.
+ *
+ * Shows a colorful, Polish-language welcome with a brief spinner and box-drawn
+ * next-steps panel. Designed to be:
+ *   - fast (< 2s total)
+ *   - safe  (any error → silent exit 0; never breaks `npm install`)
+ *   - quiet during monorepo/dev installs (full message only for end users)
+ *
+ * Tagline: "Agent kodujący który nigdy nie śpi"
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// picocolors is a direct dependency of @aexol/spectral and used across the CLI.
+// Fallback to identity functions if (somehow) unavailable so colors degrade
+// gracefully rather than crashing the install.
+let pc = null;
+try {
+  pc = (await import("picocolors")).default;
+} catch {
+  pc = null;
+}
+
+/** Wrap a string in an ANSI color; no-op when picocolors is missing. */
+const c = (style, s) => {
+  if (!pc) return s;
+  const fn = pc[style];
+  return typeof fn === "function" ? fn(s) : s;
+};
+
+const write = (s) => process.stdout.write(s);
+
+// Strip ANSI escapes so we can measure visible width for box padding.
+const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+
+// ─── Dev install detection ──────────────────────────────────────────────────
+// In the monorepo, `../deno.json` + `../AGENTS.md` exist relative to this
+// script. End-user installs (from npm) live under
+// node_modules/@aexol/spectral/ and have no monorepo root above them.
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const monorepoRoot = join(__dirname, "..", "..");
+const isMonorepoDevInstall =
+  existsSync(join(monorepoRoot, "deno.json")) &&
+  existsSync(join(monorepoRoot, "AGENTS.md"));
+
+// Read own package.json (shipped in the tarball) for version display.
+function readVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+    return pkg.version || "";
+  } catch {
+    return "";
+  }
+}
+
+// ─── Spinner ──────────────────────────────────────────────────────────────────
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+
+function spin(message, ms = 900) {
+  return new Promise((resolve) => {
+    const interactive =
+      process.stdout.isTTY && !process.env.CI && !process.env.NO_COLOR;
+    if (!interactive) {
+      // Non-interactive (npm logs / CI): print a single static line, brief wait.
+      write(c("dim", "• " + message) + "\n");
+      setTimeout(resolve, Math.min(ms, 200));
+      return;
+    }
+    let i = 0;
+    const timer = setInterval(() => {
+      write("\r\x1b[K"); // clear line
+      write(
+        c("cyan", SPINNER_FRAMES[i % SPINNER_FRAMES.length]) +
+          " " +
+          c("dim", message),
+      );
+      i++;
+    }, 80);
+    setTimeout(() => {
+      clearInterval(timer);
+      write("\r\x1b[K"); // clear spinner line
+      resolve();
+    }, ms);
+  });
+}
+
+// ─── Box drawing ─────────────────────────────────────────────────────────────
+/** Render `lines` inside a rounded Unicode box with `borderColor`. */
+function box(lines, { borderColor = "cyan" } = {}) {
+  const width = Math.max(...lines.map((l) => stripAnsi(l).length)) + 4;
+  const top = c(borderColor, "╭" + "─".repeat(width - 2) + "╮");
+  const bottom = c(borderColor, "╰" + "─".repeat(width - 2) + "╯");
+  const rule = c(borderColor, "├" + "─".repeat(width - 2) + "┤");
+  const pad = (s) => {
+    const visible = stripAnsi(s).length;
+    const spaces = Math.max(0, width - 2 - 1 - visible);
+    return (
+      c(borderColor, "│") +
+      " " +
+      s +
+      " ".repeat(spaces) +
+      " " +
+      c(borderColor, "│")
+    );
+  };
+  return [top, ...lines.map(pad), bottom].join("\n");
+}
+
+// ─── Welcome panel ───────────────────────────────────────────────────────────
+function renderWelcome() {
+  const version = readVersion();
+  const versionStr = version ? c("dim", `v${version}`) : "";
+
+  const headerLine =
+    "  " +
+    c("green", "✅") +
+    "  " +
+    c("magenta", c("bold", "@aexol/spectral")) +
+    " installed successfully " +
+    versionStr;
+
+  const blank = " ";
+  const tagline =
+    "  " + c("italic", c("dim", "Coding agent that never sleeps 🌙"));
+
+  const stepsTitle = "  " + c("bold", "Next steps:");
+  const step1 =
+    "  " +
+    c("cyan", "1.") +
+    "  " +
+    c("yellow", c("bold", "spectral login")) +
+    c("dim", "  — log in to your Aexol account");
+  const step2 =
+    "  " +
+    c("cyan", "2.") +
+    "  " +
+    c("yellow", c("bold", "spectral serve")) +
+    c("dim", "  — start the agent in your projects folder");
+
+  const tip =
+    "  " +
+    c("blue", "💡") +
+    " " +
+    c("dim", "Run ") +
+    c("yellow", "spectral serve") +
+    c("dim", " in the directory where you keep your projects.");
+
+  const lines = [
+    headerLine,
+    blank,
+    tagline,
+    blank,
+    stepsTitle,
+    step1,
+    step2,
+    blank,
+    tip,
+  ];
+  return box(lines, { borderColor: "magenta" });
+}
+
+// ─── Dev (short) message ─────────────────────────────────────────────────────
+function renderDevHint() {
+  return (
+    c("dim", "  ↻ @aexol/spectral — dev install (monorepo), skipping welcome") +
+    "\n"
+  );
+}
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+try {
+  if (isMonorepoDevInstall) {
+    write(renderDevHint());
+  } else {
+    // Total runtime < ~1.2s: spinner ~900ms, then synchronous render.
+    await spin("Setting up @aexol/spectral…", 900);
+    write("\n" + renderWelcome() + "\n\n");
+  }
+} catch {
+  // Never break `npm install`. Silent failure.
+}
+
+process.exit(0);