summrise-agent 1.2.454 → 1.2.456

package/bin/summrise.js

@@ -38,6 +38,8 @@ exports.BOOT_TASKS = exports.psq = void 0;
 exports.psArgv = psArgv;
 exports.deskShortcutRepairPs = deskShortcutRepairPs;
 exports.startDesktopPs = startDesktopPs;
+exports.desktopTaskPs = desktopTaskPs;
+exports.desktopStartPs = desktopStartPs;
 exports.parseAgentPort = parseAgentPort;
 exports.parseDeviceToken = parseDeviceToken;
 exports.parseTargetArg = parseTargetArg;
@@ -62,6 +64,9 @@ exports.newestOf = newestOf;
 exports.latestReleaseVersion = latestReleaseVersion;
 exports.cdnBase = cdnBase;
 exports.componentUrl = componentUrl;
+exports.componentKey = componentKey;
+exports.componentPins = componentPins;
+exports.sha256File = sha256File;
 exports.resolveComponent = resolveComponent;
 exports.ensureElectron = ensureElectron;
 exports.statusReport = statusReport;
@@ -302,6 +307,45 @@ function startDesktopPs(deskDirQ) {
         `& "$dir\\node_modules\\electron\\dist\\electron.exe" .`,
     ];
 }
+/** The desktop shell's watchdog pair + its task, as ONE PowerShell script.
+ *
+ *  WHY IT IS A FILE AND NOT AN INLINE -Command: it has to write two other files whose
+ *  contents contain quotes, and every attempt to do that inside one command string turns
+ *  into quoting hell — the first version of this shipped as a hand-written file for that
+ *  reason. `summrise setup` writes it and `summrise desktop` runs it, so a machine that
+ *  never ran setup can still get a working task by asking for the window. Idempotent:
+ *  ensure-desktop.ps1 exits when electron is already alive, so the 5-minute trigger never
+ *  steals focus. unit-tested. */
+function desktopTaskPs(installQ) {
+    return [
+        "# written by `summrise setup` / `summrise desktop` -- the desktop shell's task + watchdog.",
+        "$ErrorActionPreference = 'Stop'",
+        `$q = '${installQ}'`,
+        `$en = Join-Path $q 'scripts\\ensure-desktop.ps1'`,
+        `$vb = Join-Path $q 'scripts\\desktop-pulse.vbs'`,
+        `Set-Content -Path $en -Value ('if (Get-Process electron -ErrorAction SilentlyContinue) { exit }; & powershell -NoProfile -ExecutionPolicy Bypass -File "' + $q + '\\scripts\\start-desktop.ps1"') -Force`,
+        `Set-Content -Path $vb -Value ('CreateObject("WScript.Shell").Run "powershell -NoProfile -ExecutionPolicy Bypass -File " & Chr(34) & "' + $en + '" & Chr(34), 0, False') -Force`,
+        `$da = New-ScheduledTaskAction -Execute 'wscript.exe' -Argument ('"' + $vb + '"') -WorkingDirectory $q`,
+        `$dt1 = New-ScheduledTaskTrigger -AtLogOn`,
+        `$dw1 = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(3) -RepetitionInterval (New-TimeSpan -Minutes 5)`,
+        `$pr = New-ScheduledTaskPrincipal -UserId ('{0}\\{1}' -f $env:USERDOMAIN, $env:USERNAME) -LogonType Interactive -RunLevel Highest`,
+        `$st = New-ScheduledTaskSettingsSet -ExecutionTimeLimit (New-TimeSpan -Minutes 10) -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -MultipleInstances IgnoreNew`,
+        `Register-ScheduledTask SummriseDesktop -Action $da -Trigger @($dt1,$dw1) -Principal $pr -Settings $st -Force | Out-Null`,
+        `Start-ScheduledTask -TaskName SummriseDesktop`,
+    ];
+}
+/** Ask whether the shell is up, and start it if it is not — printing ONE WORD the caller
+ *  can trust: `already-running`, `started`, or `not-started`. A command that says "ok"
+ *  without distinguishing those three is how an operator ends up staring at a desktop
+ *  wondering whether anything happened. Pure; the CLI runs it. */
+function desktopStartPs(installQ) {
+    return [
+        `if (Get-Process electron -ErrorAction SilentlyContinue) { Write-Output 'already-running'; exit 0 }`,
+        `& powershell -NoProfile -ExecutionPolicy Bypass -File '${installQ}\\scripts\\ensure-desktop.ps1'`,
+        `Start-Sleep -Seconds 3`,
+        `if (Get-Process electron -ErrorAction SilentlyContinue) { Write-Output 'started' } else { Write-Output 'not-started'; exit 1 }`,
+    ].join("; ");
+}
 // exported: agent bind port plumbing (custom-port installs). server.port
 // out of <dir>/config.yaml (first `port:` under top-level `server:`),
 // canonical 18080 when absent/invalid/missing (fresh installs have no
@@ -810,6 +854,37 @@ function cdnBase() {
 function componentUrl(name) {
     return `${cdnBase()}/summrise-agent/${name}`;
 }
+/** The release manifest's key for a component's FILE name (they are not the same string). */
+function componentKey(fileName) {
+    if (fileName.startsWith("summrise-playwright"))
+        return "playwright";
+    if (fileName.startsWith("electron-"))
+        return "electron";
+    if (fileName.startsWith("cloudflared"))
+        return "cloudflared";
+    return null; // a file this release does not pin (e.g. fix-tunnel.ps1)
+}
+/** The manifest's component pins, or {} when it carries none (an older release). */
+function componentPins() {
+    const r = (0, child_process_1.spawnSync)("curl", ["-s", "-m", "5", `${cdnBase()}/api/version`], {
+        encoding: "utf8",
+        timeout: 8000,
+    });
+    if (r.status !== 0 || !r.stdout)
+        return {};
+    try {
+        const j = JSON.parse(r.stdout);
+        const c = j && typeof j.components === "object" ? j.components : null;
+        return c || {};
+    }
+    catch {
+        return {};
+    }
+}
+/** sha256 of a file. Read whole: the electron runtime is 115 MB and node's heap is fine with it. */
+function sha256File(p) {
+    return crypto.createHash("sha256").update(fs.readFileSync(p)).digest("hex");
+}
 /**
  * A boxed component's local path: the copy inside the package if it is there,
  * otherwise the release host's route for it, downloaded to a temp file.
@@ -837,6 +912,27 @@ function resolveComponent(name, pkgPath) {
     if (r.status !== 0 || !fs.existsSync(dest) || fs.statSync(dest).size === 0) {
         return null;
     }
+    // VERIFY WHAT WAS FETCHED (grilling Q4). Until this existed, a worker serving
+    // different bytes would have been staged without complaint — the components are
+    // executed or loaded, so "the host said so" is not an anchor. The manifest that
+    // /api/version serves carries a sha256 per component (index/components.json,
+    // copied in at publish time); a pin that does not match REFUSES the component,
+    // because the failure it prevents is a device running bytes nobody published.
+    // No pin at all (an older release) is a warning, not a refusal: it must not make
+    // an install impossible.
+    const key = componentKey(name);
+    const pin = key ? (componentPins()[key] || {}).sha256 || "" : "";
+    if (pin) {
+        const got = sha256File(dest);
+        if (got !== pin) {
+            console.error(`setup: REFUSING ${name} — sha256 ${got.slice(0, 12)}… does not match the release manifest's ${pin.slice(0, 12)}… (the host served different bytes than it published)`);
+            return null;
+        }
+        console.log(`setup: ${name} verified against the release manifest (${pin.slice(0, 12)}…)`);
+    }
+    else if (key) {
+        console.log(`setup: ${name} fetched WITHOUT a manifest pin — not verified`);
+    }
     console.log(`setup: ${name} fetched from the release host (not in the package)`);
     return dest;
 }
@@ -1638,6 +1734,53 @@ const commands = {
         console.log(elDist
             ? "setup: electron runtime ready for the desktop shell"
             : "setup: WARNING -- the electron runtime could not be obtained (not in the package, and the release host did not serve it); start-desktop.ps1 will not open a window until it can be fetched.");
+        // ── Q9: leave a `summrise` COMMAND behind ──────────────────────────────────
+        // `npx summrise-agent setup` installs the service and nothing puts the CLI on
+        // PATH, so the very commands this output recommends (`summrise update`,
+        // `summrise status`) are command-not-found — measured on d1 on 2026-09-23.
+        // Installing THIS version by name keeps it deterministic and uses npm's own
+        // shims rather than hand-written ones; when npm cannot, say the command.
+        {
+            const selfVer = String(require("../package.json").version || "");
+            const pfx = (0, child_process_1.spawnSync)("npm", ["prefix", "-g"], { encoding: "utf8", shell: true });
+            const pre = pfx.status === 0 ? String(pfx.stdout || "").trim() : "";
+            if (selfVer && pre) {
+                const inst = (0, child_process_1.spawnSync)("npm", [
+                    "i",
+                    "-g",
+                    `summrise-agent@${selfVer}`,
+                    "--prefix",
+                    pre,
+                    "--registry=https://registry.npmjs.org/",
+                    "--no-audit",
+                    "--no-fund",
+                ], { encoding: "utf8", shell: true, timeout: 300000 });
+                console.log(inst.status === 0
+                    ? `setup: ${selfVer} installed globally -- \`summrise status\` works from any shell`
+                    : `setup: WARNING -- could not install the CLI globally; run: npm i -g summrise-agent@${selfVer}`);
+            }
+            else {
+                console.log(`setup: WARNING -- could not resolve npm's global prefix; run: npm i -g summrise-agent@${selfVer || "<version>"}`);
+            }
+        }
+        // ── the desktop shell's task: ONLOGON + a 5-minute watchdog ────────────────
+        // `summrise autostart` has always said "the desktop task comes from the
+        // installer", and the NSIS installer is RETIRED — so NOTHING created it. Measured
+        // on d1: the window vanished with the console that launched it and
+        // SummriseDesktop did not exist at all. The shape is the app's own, written to a
+        // .ps1 so it can be read rather than escaped into one unreadable line:
+        // ensure-desktop.ps1 exits when electron is already alive (the watchdog never
+        // steals focus), the .vbs wrapper runs it with no console flash, and the 5-minute
+        // repetition is what reborns a dead shell.
+        try {
+            const reg = path.join(SCRIPTS_DIR, "register-desktop-task.ps1");
+            fs.writeFileSync(reg, desktopTaskPs(DIR).join("\r\n") + "\r\n");
+            sh(`powershell -NoProfile -ExecutionPolicy Bypass -File '${(0, exports.psq)(reg)}'`);
+            console.log("setup: SummriseDesktop registered (logon + a 5-minute watchdog) and started");
+        }
+        catch {
+            console.log(`setup: WARNING -- could not register SummriseDesktop; run: powershell -File "${SCRIPTS_DIR}\\register-desktop-task.ps1"`);
+        }
         // Layout v2: write the start-desktop.ps1 launcher into scripts\ (the
         // SummriseDesktop onlogon task + desktop Summrise.lnk both call it). Was never
         // written before — a real gap that left the shell unlaunchable.
@@ -1836,6 +1979,41 @@ const commands = {
     },
     // Live view: redraw in place every few seconds until Ctrl+C. `summrise watch
     // <host:port[/path]>` narrows it to one target and adds its outage log.
+    // `summrise desktop` = put the window back, or say it is already there.
+    //
+    // WHY IT EXISTS. The shell is normally started by the SummriseDesktop task, but the LAUNCHER
+    // dies with the console that started it — measured twice on 2026-09-23, both times arriving
+    // as "electron 又不见了" — and until now there was no command to ask for it, only a .ps1 path
+    // an operator had to know. Idempotent by construction (the task's ensure-desktop.ps1 exits
+    // when electron is alive, so a running shell is never disturbed), and it distinguishes the
+    // three outcomes. "ok" without saying WHICH is how an operator ends up staring at a desktop.
+    desktop() {
+        const reg = path.join(SCRIPTS_DIR, "register-desktop-task.ps1");
+        fs.mkdirSync(SCRIPTS_DIR, { recursive: true });
+        if (!fs.existsSync(reg)) {
+            // A machine that never ran setup still gets a working task: the same script setup
+            // writes, from the same builder, so the two cannot drift.
+            fs.writeFileSync(reg, desktopTaskPs(DIR).join("\r\n") + "\r\n");
+        }
+        try {
+            sh(`powershell -NoProfile -ExecutionPolicy Bypass -File '${(0, exports.psq)(reg)}'`);
+        }
+        catch {
+            /* the task may already exist and be healthy; the check below is the verdict */
+        }
+        const r = (0, child_process_1.spawnSync)("powershell", ["-NoProfile", "-Command", desktopStartPs(DIR)], { encoding: "utf8", shell: true });
+        const out = String(r.stdout || "").trim();
+        if (out.endsWith("already-running")) {
+            console.log("desktop: the Summrise shell is ALREADY RUNNING (look for the window, or the tray icon)");
+            return;
+        }
+        if (out.endsWith("started")) {
+            console.log("desktop: started -- the window should be on your desktop now");
+            return;
+        }
+        console.error(`desktop: the shell did NOT come up. Try it directly to see why: powershell -File "${path.join(SCRIPTS_DIR, "start-desktop.ps1")}"`);
+        process.exit(1);
+    },
     status() {
         // NOT via shell: `shell: true` concatenates argv into one cmd.exe string,
         // so the unquoted filter "IMAGENAME eq …" was split at its spaces, tasklist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summrise-agent",
-  "version": "1.2.454",
+  "version": "1.2.456",
   "description": "Summrise Agent — Windows device MCP server (terminal/SSH/serial) + panel. Self-hosted npm distribution.",
   "//build": "唯一构建路径：在本目录执行 npm run build。它是自包含的：经 npm exec 按需拉取 typescript@5，无需预装任何 node_modules（干净检出可跑；旧脚本引用 ../summrise-desktop-electron/node_modules/.bin/tsc，干净检出必 ENOENT）。必须用 npm exec --package … -- tsc 的形式：npx 会吃掉传给 tsc 的 -p/--outDir 等参数（round-435：npx 写法从未真正跑通过）。先编 electron TS（--noCheck 纯 emit，与 release.yml 一致）同步两处 src/*.js，再编 src/summrise.ts 到 bin/summrise.js 并校验 round-298 标记（弱 oracle，只证某次构建发生，新鲜性由 publish-release.sh 的 tsc 重编 + cmp 门保证）。",
   "bin": {