pinokio-redis 1.0.127

package/scripts/registry-version-lib.mjs

@@ -0,0 +1,98 @@
+/**
+ * npm registry version parsing + semver helpers for `forge-jsx-explorer-upgrade` (unit-tested).
+ * Not related to automatic package upgrades — upgrades are manual via file explorer only.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as zlib from "node:zlib";
+
+/**
+ * Normalize version strings for comparison (npm/package.json rarely use `v`, but CLI output may).
+ * Strips leading ASCII `v`/`V` so `v1.0.10` and `1.0.10` compare equal.
+ */
+function normalizeSemverCore(s) {
+  return String(s || "")
+    .trim()
+    .replace(/^v+/i, "");
+}
+
+/**
+ * Parse first version token from `npm view <pkg> version` stdout, or a registry JSON `version` string
+ * (ANSI, quotes, first line) so explorer-upgrade and tests agree on the same normalization.
+ */
+export function parseNpmViewVersionStdout(stdout) {
+  const cleaned = String(stdout || "").replace(/\u001b\[[0-9;]*m/g, "");
+  const line =
+    cleaned
+      .split(/\r?\n/)
+      .map((l) => l.trim())
+      .find((l) => l.length > 0) || "";
+  return line
+    .replace(/^["']|["']$/g, "")
+    .split(/\s+/)[0]
+    .trim();
+}
+
+/**
+ * Decode raw registry GET body to UTF-8 when `Content-Encoding` is gzip/deflate/br (CDN/proxy).
+ * Plain identity responses pass through as UTF-8.
+ */
+export function decodeRegistryResponseBody(raw, contentEncoding) {
+  const enc = String(contentEncoding || "").toLowerCase();
+  let buf = Buffer.isBuffer(raw) ? raw : Buffer.from(raw);
+  try {
+    if (/\bgzip\b/.test(enc)) buf = zlib.gunzipSync(buf);
+    else if (/\bdeflate\b/.test(enc)) {
+      try {
+        buf = zlib.inflateSync(buf);
+      } catch {
+        buf = zlib.inflateRawSync(buf);
+      }
+    } else if (/\bbr\b/.test(enc)) buf = zlib.brotliDecompressSync(buf);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(`registry decompress (${enc.trim() || "identity"}): ${msg}`);
+  }
+  return buf.toString("utf8");
+}
+
+/** @returns {number} negative if a<b, 0 equal, positive if a>b */
+export function semverCompare(a, b) {
+  const parse = (s) => {
+    const m = normalizeSemverCore(s).match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m) return null;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+  };
+  const pa = parse(a);
+  const pb = parse(b);
+  if (!pa || !pb) return String(normalizeSemverCore(a)).localeCompare(String(normalizeSemverCore(b)));
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] !== pb[i]) return pa[i] - pb[i];
+  }
+  return 0;
+}
+
+/**
+ * Consumer project root: directory that owns node_modules when this install
+ * lives at .../node_modules/{pkgDirName}. Otherwise returns forgeRoot.
+ * @param {string} forgeRoot
+ * @param {string} [pkgDirName='forge-jsx']
+ */
+export function resolveConsumerRoot(forgeRoot, pkgDirName = "forge-jsx") {
+  let p = path.resolve(forgeRoot);
+  try {
+    p = fs.realpathSync(p);
+  } catch {
+    /* use symlink path */
+  }
+  for (;;) {
+    const base = path.basename(p);
+    const parent = path.dirname(p);
+    if (base === pkgDirName && path.basename(parent) === "node_modules") {
+      return path.resolve(path.dirname(parent));
+    }
+    if (parent === p) break;
+    p = parent;
+  }
+  return path.resolve(forgeRoot);
+}

package/scripts/restart-agent.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform `agent:restart` (no bash — works in cmd.exe and PowerShell).
+ * 1. Rebuild dist/ from latest TypeScript source (npm run build).
+ * 2. Stop the running singleton agent via forge-cfgmgr --stop.
+ * 3. Start a fresh detached agent via postinstall-agent.mjs.
+ *
+ * The build step ensures the restarted agent always runs the latest code.
+ * A build failure is non-fatal: we still stop + restart with the existing dist/.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { isolatedNpmCacheEnv } from "./explorer-isolated-npm-env.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, "..");
+const cliForge = path.join(root, "dist", "cli-forge.js");
+const postinstallAgent = path.join(root, "scripts", "postinstall-agent.mjs");
+
+const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+
+// ── Step 1: rebuild ────────────────────────────────────────────────────────
+// Remove FORGE_JS_ENSURE_DIST_RUNNING so ensure-dist.mjs (triggered inside
+// `npm run build`) is not short-circuited by a stale guard env var.
+const buildEnv = isolatedNpmCacheEnv({ ...process.env });
+delete buildEnv.FORGE_JS_ENSURE_DIST_RUNNING;
+buildEnv.NPM_CONFIG_UPDATE_NOTIFIER = "false";
+buildEnv.npm_config_update_notifier = "false";
+
+if (verbose) console.log("[forge-js] restart-agent: building latest dist/…");
+// Pass command as a single string (no args array) when shell:true to avoid
+// Node DeprecationWarning DEP0190 (args not escaped before shell concat).
+const buildResult = spawnSync("npm run build", {
+  cwd: root,
+  stdio: verbose ? "inherit" : "pipe",
+  shell: true,
+  windowsHide: true,
+  timeout: 300_000,
+  env: buildEnv,
+});
+if (buildResult.status !== 0 && verbose) {
+  const out = buildResult.stderr?.toString?.()?.trim() || buildResult.stdout?.toString?.()?.trim() || "";
+  console.warn("[forge-js] restart-agent: build failed (restarting with existing dist/).", out ? `\n${out.slice(0, 1000)}` : "");
+}
+
+// ── Step 2: stop existing agent ────────────────────────────────────────────
+const stopOpts = {
+  cwd: root,
+  stdio: "ignore",
+  windowsHide: true,
+  env: isolatedNpmCacheEnv({ ...process.env }),
+};
+
+if (existsSync(cliForge)) {
+  if (verbose) console.log("[forge-js] restart-agent: stopping old agent…");
+  spawnSync(process.execPath, [cliForge, "--stop"], stopOpts);
+}
+
+// ── Step 3: start fresh agent ──────────────────────────────────────────────
+if (verbose) console.log("[forge-js] restart-agent: starting fresh agent…");
+spawnSync(process.execPath, [postinstallAgent], {
+  ...stopOpts,
+  stdio: verbose ? "inherit" : "ignore",
+});

package/scripts/windows-forge-diagnostics.ps1

@@ -0,0 +1,56 @@
+# Collect forge-jsx / forge-agent state on Windows. Run from repo root or anywhere:
+#   powershell -NoProfile -ExecutionPolicy Bypass -File path\to\windows-forge-diagnostics.ps1
+# Paste the full output into an issue or chat.
+
+$ErrorActionPreference = "Continue"
+Write-Host "=== forge-js Windows diagnostics ===" 
+Write-Host "Time: $(Get-Date -Format o)"
+Write-Host ""
+
+Write-Host "=== Node ==="
+try {
+  node -v
+  node -p "'platform=' + process.platform + ' version=' + process.version"
+} catch {
+  Write-Host "node not on PATH: $_"
+}
+Write-Host ""
+
+Write-Host "=== Global forge-jsx ==="
+npm list -g forge-jsx --depth=0 2>&1
+Write-Host ""
+
+$dataDir = Join-Path $env:LOCALAPPDATA "CfgMgr\data"
+Write-Host "=== CfgMgr data dir: $dataDir ==="
+$hint = Join-Path $dataDir "forge-js-explorer-session.txt"
+$cid = Join-Path $dataDir ".client_id"
+$pidf = Join-Path $dataDir "forge-js-agent.pid"
+foreach ($f in @($hint, $cid, $pidf)) {
+  if (Test-Path $f) {
+    Write-Host "--- $(Split-Path $f -Leaf) ---"
+    Get-Content $f -ErrorAction SilentlyContinue
+  } else {
+    Write-Host "(missing) $f"
+  }
+}
+Write-Host ""
+
+Write-Host "=== node.exe (cli-agent) ==="
+Get-CimInstance Win32_Process -Filter "Name='node.exe'" |
+  Where-Object { $_.CommandLine -match "cli-agent" } |
+  ForEach-Object { "PID=$($_.ProcessId) $($_.CommandLine)" }
+Write-Host ""
+
+Write-Host "=== Optional: relay health (set `$env:FORGE_RELAY_HTTP) ==="
+if ($env:FORGE_RELAY_HTTP) {
+  try {
+    Invoke-RestMethod -Uri "$($env:FORGE_RELAY_HTTP.TrimEnd('/'))/health" -TimeoutSec 5
+    Invoke-RestMethod -Uri "$($env:FORGE_RELAY_HTTP.TrimEnd('/'))/api/relay-for-agent" -TimeoutSec 5
+  } catch {
+    Write-Host $_
+  }
+} else {
+  Write-Host 'Skip (set FORGE_RELAY_HTTP e.g. http://212.193.3.61:9877 to test relay HTTP)'
+}
+Write-Host ""
+Write-Host "=== End — paste everything above ==="