@rubytech/create-realagent 1.0.669 → 1.0.671

package/dist/index.js

@@ -207,14 +207,112 @@ function canSudo() {
     return result.status === 0;
 }
 // Task 634 — verified-not-asserted apt-dep reconciliation.
-//
-// Returns the subset of `pkgs` that are not currently installed. Uses
-// `dpkg -s <pkg>` per package (exit 0 = installed, any non-zero = missing)
-// so we never parse dpkg's prose output for control flow
-// (feedback_no_stdout_parsing_for_control_flow.md).
+// Task 637 — resolve package-name aliases before probing dpkg, so the
+// post-install check no longer false-negatives when apt resolves a virtual
+// name (e.g. Noble's `chromium` → `chromium-browser`).
+// Virtual-package aliases applied when `apt-cache policy <pkg>` returns
+// `Candidate: (none)`. Keyed by apt-level alias, valued by the real .deb
+// name actually recorded in dpkg after install. Scoped per distro family
+// by the caller in `resolveAptName`. Add entries here if a new alias class
+// surfaces — no code surgery needed.
+const UBUNTU_ALIASES = {
+    // Noble ships `chromium` as a virtual package that resolves to
+    // `chromium-browser`, which is itself a transitional stub delegating to
+    // the snap. The runtime binary at /usr/bin/chromium is a snap symlink;
+    // dpkg records `chromium-browser` post-install, never `chromium`.
+    chromium: "chromium-browser",
+};
+function readOsRelease() {
+    try {
+        const raw = readFileSync("/etc/os-release", "utf-8");
+        const out = {};
+        for (const line of raw.split("\n")) {
+            const m = line.match(/^([A-Z_]+)=(.*)$/);
+            if (m)
+                out[m[1]] = m[2].replace(/^"|"$/g, "");
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+function isUbuntuLike() {
+    const os = readOsRelease();
+    if (os.ID === "ubuntu")
+        return true;
+    const likes = (os.ID_LIKE ?? "").split(/\s+/);
+    return likes.includes("ubuntu");
+}
+/** Summarise `apt-cache policy` output for diagnostics — one token per package. */
+function aptCachePolicySummary(pkg) {
+    const r = spawnSync("apt-cache", ["policy", pkg], { stdio: "pipe", encoding: "utf-8", timeout: 5_000 });
+    if (r.status !== 0)
+        return "policy-spawn-failed";
+    const out = r.stdout ?? "";
+    const cand = out.match(/Candidate:\s*(\S+)/);
+    if (!cand)
+        return "no-candidate-line";
+    return cand[1] === "(none)" ? "candidate-none" : `candidate=${cand[1]}`;
+}
+/**
+ * Task 637 — map an apt-level package name to the concrete name dpkg will
+ * record after install. Resolution order:
+ *   1. `dpkg -s pkg` exits 0 → name is concrete and installed; return pkg.
+ *   2. `apt-cache policy pkg` reports a real Candidate → concrete-but-missing;
+ *      return pkg (apt-get install + post-check will use the same name).
+ *   3. `apt-cache policy pkg` reports `Candidate: (none)` and `pkg` is in
+ *      UBUNTU_ALIASES on an Ubuntu-like host → return the alias. Log the
+ *      resolution so the install log answers "what did apt resolve this to?".
+ *   4. Otherwise return pkg unchanged — the post-check will throw loudly,
+ *      preserving Task 634's fail-loud contract for genuinely missing packages.
+ */
+function resolveAptName(pkg) {
+    const dpkg = spawnSync("dpkg", ["-s", pkg], { stdio: "pipe", timeout: 5_000 });
+    if (dpkg.status === 0)
+        return pkg;
+    const policy = spawnSync("apt-cache", ["policy", pkg], {
+        stdio: "pipe", encoding: "utf-8", timeout: 5_000,
+    });
+    if (policy.status === 0) {
+        const cand = (policy.stdout ?? "").match(/Candidate:\s*(\S+)/);
+        if (cand && cand[1] !== "(none)")
+            return pkg;
+    }
+    if (isUbuntuLike() && Object.prototype.hasOwnProperty.call(UBUNTU_ALIASES, pkg)) {
+        const alias = UBUNTU_ALIASES[pkg];
+        const os = readOsRelease();
+        const distro = `${os.ID ?? "unknown"}-${os.VERSION_CODENAME ?? "unknown"}`;
+        logFile(`  apt-resolve ${pkg} → ${alias} (reason=candidate-none, distro=${distro})`);
+        return alias;
+    }
+    return pkg;
+}
+/** Probe runtime binary presence on PATH (independent of dpkg-recorded state). */
+function commandVPath(pkg) {
+    const r = spawnSync("which", [pkg], { stdio: "pipe", encoding: "utf-8", timeout: 5_000 });
+    return r.status === 0 ? (r.stdout ?? "").trim() || "missing" : "missing";
+}
+/** Probe snap-recorded state for a name (snap lives outside dpkg). */
+function snapStatus(pkg) {
+    const r = spawnSync("snap", ["list", pkg], { stdio: "pipe", encoding: "utf-8", timeout: 5_000 });
+    if (r.status !== 0)
+        return "none";
+    const line = (r.stdout ?? "").split("\n").find((l) => l.startsWith(pkg));
+    return line ? line.split(/\s+/).slice(0, 2).join(" ") : "none";
+}
+/**
+ * Returns the subset of `pkgs` that are not currently installed, after
+ * alias resolution. Uses `dpkg -s <resolved>` per package (exit 0 = installed,
+ * any non-zero = missing) so we never parse dpkg's prose output for control
+ * flow (feedback_no_stdout_parsing_for_control_flow.md). The operator-facing
+ * name stays the original `pkg` — the resolution is logged but not renamed
+ * in the returned list, so diagnostics match what the installer declared.
+ */
 function pkgsMissing(pkgs) {
     return pkgs.filter((p) => {
-        const r = spawnSync("dpkg", ["-s", p], { stdio: "pipe", timeout: 5_000 });
+        const resolved = resolveAptName(p);
+        const r = spawnSync("dpkg", ["-s", resolved], { stdio: "pipe", timeout: 5_000 });
         return r.status !== 0;
     });
 }
@@ -224,13 +322,25 @@ function pkgsMissing(pkgs) {
  * partial-failure class where `apt-get install` returns 0 but a package did
  * not actually install — silent regressions that would otherwise only
  * surface at runtime when the binary is missing.
+ *
+ * Resolves each package through `resolveAptName` before both the install
+ * command and the post-check, so alias packages (Task 637) pass through
+ * cleanly on distros where the apt-level name differs from the dpkg-recorded
+ * name (e.g. Noble's chromium → chromium-browser). Resolution is computed
+ * once per package and reused across install, post-check, and error
+ * diagnostics — three spawnSync chains per package, not nine on failure.
  */
 function installAptGroup(label, pkgs) {
-    logFile(`  apt install (${label}): ${pkgs.join(" ")}`);
-    shell("apt-get", ["install", "-y", ...pkgs], { sudo: true });
-    const stillMissing = pkgsMissing(pkgs);
+    const pairs = pkgs.map((original) => ({ original, resolved: resolveAptName(original) }));
+    logFile(`  apt install (${label}): ${pairs.map((x) => x.resolved).join(" ")}`);
+    shell("apt-get", ["install", "-y", ...pairs.map((x) => x.resolved)], { sudo: true });
+    const stillMissing = pairs.filter(({ resolved }) => {
+        const r = spawnSync("dpkg", ["-s", resolved], { stdio: "pipe", timeout: 5_000 });
+        return r.status !== 0;
+    });
     if (stillMissing.length > 0) {
-        throw new Error(`apt-get install (${label}) returned 0 but packages are still not installed per dpkg -s: ${stillMissing.join(", ")}`);
+        const diag = stillMissing.map(({ original, resolved }) => `${original} (resolved-name=${resolved}, apt-cache-policy=${aptCachePolicySummary(original)}, command-v=${commandVPath(original)}, snap-status=${snapStatus(resolved)})`).join("; ");
+        throw new Error(`apt-get install (${label}) returned 0 but packages are still not installed per dpkg -s: ${diag}`);
     }
 }
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent",
-  "version": "1.0.669",
+  "version": "1.0.671",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent": "./dist/index.js"

package/payload/platform/plugins/docs/references/troubleshooting.md

@@ -207,6 +207,42 @@ which xdotool                      # should return /usr/bin/xdotool
 
 ---
 
+## Installer aborts on Ubuntu 24.04 with `dpkg -s: chromium`
+
+**Symptom:** On a fresh (or re-run) `npx -y @rubytech/create-maxy@latest` on an Ubuntu 24.04 Noble laptop/desktop, step 1/12 aborts:
+
+```
+[1/12] System dependencies and network...
+  Missing apt deps (1): chromium
+  apt install (VNC stack): tigervnc-standalone-server python3-websockify novnc xdg-utils chromium xterm xdotool
+> sudo apt-get install -y ... chromium ...
+  OK in 0.3s
+[ERROR] Setup failed: apt-get install (VNC stack) returned 0 but packages are still not installed per dpkg -s: chromium
+```
+
+Directly probing the device shows `dpkg -s chromium` non-zero, `apt-cache policy chromium` reports `Candidate: (none)`, but `/usr/bin/chromium` exists and works, and `snap list chromium` shows the snap is installed.
+
+**What it means:** You are on a **pre-637 installer**. On Noble, `chromium` is a virtual package aliasing to `chromium-browser` — `apt-get install chromium` succeeds silently but nothing named `chromium` ever lands in dpkg's state DB. Task 634's post-install probe (correctly) notices the discrepancy and aborts. Task 637 added alias resolution (`chromium` → `chromium-browser`) so the probe matches the dpkg-recorded name and passes.
+
+**Fix:** Upgrade to a post-637 version of `@rubytech/create-maxy`:
+
+```bash
+npx -y @rubytech/create-maxy@latest
+```
+
+**Manual bypass** (if you must install before 637 publishes, or if you're on a restricted shell): pre-install the real .deb name and re-run the installer.
+
+```bash
+sudo apt-get install -y chromium-browser
+npx -y @rubytech/create-maxy@latest
+```
+
+The installer's resolver will then see `dpkg -s chromium-browser` exit 0 for the alias target, filter `chromium` out of the missing set, and skip the apt-install branch entirely. Raspberry Pi OS (Debian 12 Bookworm) is unaffected — `chromium` IS a concrete .deb on Bookworm.
+
+**Deeper diagnostic**: post-637 installer logs carry the full classification in the error message itself — `(resolved-name=<name>, apt-cache-policy=<summary>, command-v=<path>, snap-status=<summary>)`. If you see that longer form and still fail, the apt state itself is inconsistent (snap removed, `chromium-browser` uninstalled after previous install) — repair with `sudo apt-get install --reinstall -y chromium-browser`.
+
+---
+
 ## Terminal iframe renders black and cursor vanishes over the canvas
 
 **Symptom:** Header-menu Terminal click appears to succeed — no error toast, overlay opens — but the iframe renders uniformly black, keystrokes do not reach any shell, and the mouse cursor disappears the moment it enters the iframe (visible elsewhere in the page).