waterplane 0.0.1 → 0.1.6

package/packages/host/dist/capture/garmin.js

@@ -0,0 +1,294 @@
+/**
+ * The `garmin` backend — ciqkit, shelled out, and never anything else.
+ *
+ * ciqkit owns the Connect IQ simulator: it builds the project, pushes the
+ * `.prg`, verifies the app actually LOADED (Connect IQ shows a blue loading
+ * triangle that passes every cheap "is it blank / did it change" check, which
+ * is why a naive screenshot of that simulator is usually a picture of the
+ * loader), and OCRs the frame against the anchors. All of that is behind one
+ * command. This file runs that command and reads its JSON.
+ *
+ * ── Never import it, never vendor it ───────────────────────────────────────
+ *
+ * It is a Python package with its own broker, its own lease and its own
+ * lifecycle. Copying any of that here would give the machine two things that
+ * each believe they own the simulator.
+ *
+ * ── And therefore: this backend takes NO lease ─────────────────────────────
+ *
+ * `leaseKey()` returns null. ciqkit's broker IS the lease — it queues jobs and
+ * runs them one at a time. Holding a second, waterplane-side lease around a command
+ * that is already waiting on ciqkit's queue would deadlock the two against each
+ * other the moment anything else on the machine submitted a ciqkit job.
+ *
+ * ── Exit 3 is a downgrade, not a failure ───────────────────────────────────
+ *
+ * `ciqkit sim shot` exits 0 when it captured (anchor found, or OCR simply not
+ * installed), 1 when the job failed, and 3 when it captured a frame and OCR
+ * said the anchor text was NOT on it. Exit 3 still WROTE A PNG — a picture of
+ * the wrong screen is the most useful thing you can be handed when you asked
+ * for a screen and got a different one. So it records the missing anchors,
+ * downgrades the verification level, and keeps the file. Treating it as a hard
+ * failure would delete the evidence.
+ *
+ * Exit 0 with `anchor: null` means OCR is not installed, so no oracle reading
+ * happened at all — `oracle()` returns null and the level caps at `stable`.
+ * That is a different fact from "the anchor was checked and found".
+ *
+ * ── And exit 1 is two different things ─────────────────────────────────────
+ *
+ * A job that failed, and a WAIT that gave up on a job which is still running.
+ * ciqkit exits 1 for both and separates them in its JSON (`error: "wait
+ * timeout"`). The second is not a failure of anything the user did — the
+ * simulator work carries on and writes its PNG later — so it gets its own
+ * sentence, and `--max` keeps ciqkit's wait inside our own kill so the two
+ * cannot race.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, renameSync, copyFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { env } from "../env.js";
+import { envName } from "@waterplane/shared";
+const CIQKIT = env("CIQKIT_BIN") || "ciqkit";
+/** A cold push costs one simulator restart — measured at ~87 s in ciqkit's own
+ *  notes — so this is generous on purpose. */
+const SHOT_MS = 8 * 60_000;
+/**
+ * How long ciqkit itself is told to wait, in seconds — deliberately INSIDE
+ * `SHOT_MS`.
+ *
+ * `ciqkit sim shot` defaults to a 360 s wait and then exits 1 with
+ * `error: "wait timeout"` — which is not a failure: the broker's job keeps
+ * running and still writes its PNG (`docs/sim.md`). Our own 8-minute SIGKILL
+ * was outside that, so on a busy queue ciqkit gave up first and we reported
+ * "the job failed" about a job that was about to succeed. Handing ciqkit
+ * `--max` (its client-side wait, not the job's deadline) aligns the two and
+ * leaves our kill as the backstop it was meant to be.
+ */
+const SHOT_WAIT_S = Math.round(SHOT_MS / 1000) - 30;
+const SCORE_MS = 60_000;
+function run(bin, args, timeoutMs, cwd) {
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = (v) => { if (!done) {
+            done = true;
+            resolve(v);
+        } };
+        try {
+            const p = spawn(bin, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+            let out = "", err = "";
+            p.stdout.on("data", (d) => { out += d.toString(); });
+            p.stderr.on("data", (d) => { err += d.toString(); });
+            const timer = setTimeout(() => { try {
+                p.kill("SIGKILL");
+            }
+            catch { /* gone */ } finish(null); }, timeoutMs);
+            p.on("error", () => { clearTimeout(timer); finish(null); });
+            p.on("exit", (code) => { clearTimeout(timer); finish({ code, out, err }); });
+        }
+        catch {
+            finish(null);
+        }
+    });
+}
+/** The SHOT chunk's own result out of ciqkit's job JSON. */
+function shotResult(stdout) {
+    let doc;
+    try {
+        doc = JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+    const steps = doc?.job?.results;
+    if (!Array.isArray(steps))
+        return null;
+    for (const s of steps) {
+        if (s?.kind !== "shot")
+            continue;
+        const r = s.result ?? {};
+        return { path: typeof r.path === "string" ? r.path : undefined, anchor: r.anchor ?? null };
+    }
+    return null;
+}
+/**
+ * The job JSON of a wait that gave up rather than a job that failed.
+ *
+ * `ciqkit sim shot` exits 1 for both, so the exit code alone cannot tell them
+ * apart — the JSON on stdout can (`{"ok": false, "error": "wait timeout", "job":
+ * {...}}`, and ciqkit's own stderr note says the job keeps running). Null when
+ * this was a real failure.
+ */
+function waitTimeout(stdout) {
+    let doc;
+    try {
+        doc = JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+    if (doc?.error !== "wait timeout")
+        return null;
+    const job = doc?.job ?? {};
+    return {
+        jobId: typeof job.id === "string" ? job.id : undefined,
+        state: typeof job.state === "string" ? job.state : undefined,
+    };
+}
+/**
+ * `ciqkit shot-score <png> --json` → the 0-100 for one file, or null.
+ *
+ * A PATH, which `shot-score` takes as either a file or a directory — so this
+ * can be asked about the one frame that was kept, after the settle loop, rather
+ * than about a directory mid-run. It is a python process with numpy behind it;
+ * `CaptureSession.score()` is why it is now paid for once per run instead of
+ * once per discarded sample.
+ */
+async function scoreOf(file) {
+    const r = await run(CIQKIT, ["shot-score", file, "--json"], SCORE_MS);
+    if (!r || r.code === null)
+        return null;
+    let rows;
+    try {
+        rows = JSON.parse(r.out);
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(rows))
+        return null;
+    const hit = rows.find((x) => typeof x?.path === "string" && (x.path === file || String(x.path).endsWith(`/${file.split("/").pop()}`)))
+        ?? (rows.length === 1 ? rows[0] : null);
+    const n = Number(hit?.score);
+    return Number.isFinite(n) ? n : null;
+}
+class GarminSession {
+    t;
+    ctx;
+    shot = 0;
+    /** The last frame's anchor verdict, straight from ciqkit's OCR.
+     *  `null` = OCR did not run, which is NOT "the anchor was missing". */
+    lastAnchor = null;
+    constructor(t, ctx) {
+        this.t = t;
+        this.ctx = ctx;
+    }
+    async frame(absPath) {
+        const screen = this.t.screen;
+        // A fresh out-dir per frame: ciqkit names its output after the screen, so
+        // two samples into one directory would overwrite each other and the settle
+        // check would compare a file with itself.
+        const outDir = join(this.ctx.tmpDir, `ciq-${++this.shot}`);
+        mkdirSync(outDir, { recursive: true });
+        const args = ["sim", "shot", screen, "--project", this.ctx.cwd, "--out-dir", outDir,
+            "--max", String(SHOT_WAIT_S)];
+        // `--force` on the FIRST frame of the run ONLY.
+        //
+        // It defeats ciqkit's warm shortcut — the broker skips the re-push when the
+        // same project is already loaded, "which is what makes a repeat capture
+        // take 5 s instead of 80" (`docs/sim.md`). Frame 1 must force it, because
+        // the reason somebody is capturing is usually that they just rebuilt and
+        // the output path is unchanged, so the warm path would re-shoot the
+        // PREVIOUS build's screen. Frames 2+ are the settle loop asking the SAME
+        // build whether the screen has stopped moving; nothing rebuilds between
+        // them, and forcing there costs ~80 s a sample to re-push what is already
+        // up — which is the entire point of a settle loop, spent.
+        if (this.shot === 1)
+            args.push("--force");
+        if (this.t.device)
+            args.push("--device", this.t.device);
+        for (const a of this.ctx.anchors)
+            args.push("--anchor", a);
+        const r = await run(CIQKIT, args, SHOT_MS, this.ctx.cwd);
+        if (!r)
+            throw new Error(`\`${CIQKIT} sim shot\` did not finish — set ${envName("CIQKIT_BIN")} if ciqkit is somewhere unusual.`);
+        if (r.code === 1 || r.code === null) {
+            // A wait that timed out is NOT a job that failed: the simulator work
+            // carries on and writes its PNG afterwards — into a scratch dir this run
+            // is about to delete, which is why the only useful thing to say is what
+            // really happened and what to do next. Calling that "the job failed"
+            // sends somebody looking for a bug in a build that was fine.
+            const wt = r.code === 1 ? waitTimeout(r.out) : null;
+            if (wt) {
+                throw new Error(`ciqkit is still working on "${screen}" — the wait ran out after ${SHOT_WAIT_S}s with the job `
+                    + `${wt.state ?? "queued"}${wt.jobId ? ` (${wt.jobId})` : ""}. The job did NOT fail and will still finish; `
+                    + "check the queue with `ciqkit sim status` and run this target again when it is clear.");
+            }
+            throw new Error(`ciqkit could not capture "${screen}": ${(r.err || r.out).trim().slice(0, 400) || "the job failed"}`);
+        }
+        const res = shotResult(r.out);
+        const produced = res?.path && existsSync(res.path)
+            ? res.path
+            : join(outDir, `${screen}.png`);
+        if (!existsSync(produced))
+            throw new Error(`ciqkit reported success but wrote no PNG for "${screen}".`);
+        // Exit 3 = captured, and OCR contradicted the anchor. Keep the frame.
+        this.lastAnchor = r.code === 3 ? false : (res?.anchor ?? null);
+        if (r.code === 3)
+            ctx3(this.ctx, screen);
+        // No score here. It used to be taken before the move, on the theory that
+        // `shot-score` only accepts a DIRECTORY and the rename would empty this
+        // one — it accepts a FILE too, so `score()` below asks about the frame that
+        // was actually kept, once, instead of starting python per sample.
+        try {
+            renameSync(produced, absPath);
+        }
+        catch {
+            copyFileSync(produced, absPath);
+        }
+        try {
+            rmSync(outDir, { recursive: true, force: true });
+        }
+        catch { /* best-effort */ }
+        return { path: absPath };
+    }
+    /** The kept frame's 0-100, asked once per run. Null ⇒ no scorer here, which
+     *  stays ABSENT in the sidecar rather than becoming a zero. */
+    async score(absPath) {
+        return scoreOf(absPath);
+    }
+    async oracle() {
+        // No anchors asked for, or OCR never ran ⇒ nobody was asked.
+        if (!this.ctx.anchors.length || this.lastAnchor === null)
+            return null;
+        return this.lastAnchor
+            ? { found: this.ctx.anchors.slice(), missing: [] }
+            : { found: [], missing: this.ctx.anchors.slice() };
+    }
+    async end() { }
+}
+function ctx3(ctx, screen) {
+    ctx.log(`[capture] ciqkit captured "${screen}" but its OCR did not find the anchor text — frame kept, level downgraded.`);
+}
+export const garminBackend = {
+    id: "garmin",
+    async probe() {
+        const r = await run(CIQKIT, ["sim", "--help"], 30_000);
+        if (!r) {
+            return {
+                id: "garmin",
+                available: false,
+                reason: `garmin capture needs ciqkit on PATH (or ${envName("CIQKIT_BIN")} pointing at it) — \`${CIQKIT}\` did not run.`,
+            };
+        }
+        if (r.code !== 0) {
+            const said = (r.err || r.out).trim().split("\n").slice(0, 3).join(" ").slice(0, 300);
+            return { id: "garmin", available: false, reason: said || `\`${CIQKIT} sim\` exited ${r.code}.` };
+        }
+        return { id: "garmin", available: true, reason: "ciqkit is here" };
+    },
+    /** NO lease. ciqkit's broker is the lease — see the header. */
+    leaseKey() { return null; },
+    validate(t) {
+        if (!t.screen || !t.screen.trim()) {
+            return "this garmin target has no `screen` yet — it is the name `ciqkit sim shot` captures.";
+        }
+        return null;
+    },
+    passes() { return [{ label: "device" }]; },
+    async open(t, ctx) {
+        ctx.log(`[capture] ciqkit sim shot ${t.screen}${t.device ? ` --device ${t.device}` : ""}`);
+        return new GarminSession(t, ctx);
+    },
+};
+//# sourceMappingURL=garmin.js.map

package/packages/host/dist/capture/garmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garmin.js","sourceRoot":"","sources":["../../src/capture/garmin.ts"],"names":[],"mappings":"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"}

package/packages/host/dist/capture/pixels.d.ts

@@ -0,0 +1,60 @@
+import type { CaptureViewport } from "@waterplane/shared";
+/**
+ * Below this standard deviation (ImageMagick's `%[fx:standard_deviation]`,
+ * normalised 0–1) a frame is one flat colour: a page that never painted, a
+ * simulator showing its loading fill, a black screen. Not "dark" — dark UI has
+ * text in it, which is variance.
+ */
+export declare const BLANK_SD = 0.004;
+/**
+ * Which pixel tools exist here — probed once, lazily, exactly like
+ * `thumbs.ts`'s `probeTools()`.
+ *
+ * ImageMagick 7 puts everything behind one `magick` binary; 6 ships `identify`
+ * and `compare` as their own. Both are stored as full argv prefixes so no
+ * caller has to know which generation it got.
+ */
+export interface PixelTools {
+    identify: string[] | null;
+    compare: string[] | null;
+}
+export declare function probePixelTools(): Promise<PixelTools>;
+/** One human sentence naming what is missing, for `diff.reason`. */
+export declare function pixelToolReason(t: PixelTools): string;
+/**
+ * Are these two frames the same bytes?
+ *
+ * The settle check. No tool, no decode, no approximation: PNG encoders are
+ * deterministic, so an unchanged screen round-trips to an identical file. A
+ * `false` here is never "probably moved" — it is "these files differ", which on
+ * a noisy capture path (a desktop grab with a blinking cursor in it) is the
+ * honest answer and simply means the run keeps sampling until its cap.
+ */
+export declare function framesIdentical(a: string, b: string): boolean;
+/**
+ * Geometry, out of the PNG's own IHDR chunk.
+ *
+ * A 24-byte header read, not an image library: the signature and then two
+ * big-endian uint32s at a fixed offset. `null` when the file is not a PNG or is
+ * truncated — which is exactly the `window`-backend case the sidecar's optional
+ * `viewport` exists for, and the verdict's `n/a` arm prints.
+ */
+export declare function pngSize(path: string): CaptureViewport | null;
+/**
+ * How flat this frame is, 0 (one solid colour) to ~1. `null` with no tool.
+ *
+ * Never turned into a boolean here: the caller compares against `BLANK_SD` and
+ * an absent reading means the blank check did not run, which the verdict says
+ * rather than guessing "not blank".
+ */
+export declare function blankVariance(path: string): Promise<number | null>;
+/**
+ * Percent of pixels that differ between two frames, or `null` when nothing here
+ * could measure it.
+ *
+ * `compare -metric AE` counts absolutely-different pixels and prints the count
+ * on STDERR; it exits 1 when the images differ, which is the expected outcome
+ * and not an error. Exit 2 (different geometry, unreadable file) is a real
+ * failure and comes back `null` — a resized window is not "0% changed".
+ */
+export declare function changedPct(a: string, b: string): Promise<number | null>;

package/packages/host/dist/capture/pixels.js

@@ -0,0 +1,199 @@
+/**
+ * The pixel toolkit, shelled out — `thumbs.ts`'s model, for the same reason.
+ *
+ * Node has no image decoder and `sharp` is banned repo-wide (a native dep that
+ * has to build on every host). So every measurement here is either a header
+ * read or a subprocess, and EVERY one of them degrades to `null` rather than to
+ * a number nobody measured. A `changedPct` of 0 means "ImageMagick compared the
+ * two files and found no differing pixels"; `null` means "nothing on this
+ * machine could look". They are opposite facts and the sidecar keeps them apart
+ * (`diff.changedPct` vs `diff.reason`).
+ *
+ * ── Why byte-equality comes first ──────────────────────────────────────────
+ *
+ * The settle check only ever asks "did the screen stop moving", and two PNGs of
+ * an identical screen written by one encoder are byte-identical. That check
+ * needs no tool at all, which is what lets a machine with no ImageMagick still
+ * reach `settled:stable`. The expensive comparison is only needed for the WATCH
+ * gate, where the question is "how MUCH did it change" and a threshold is being
+ * applied — and that one is allowed to come back `null`.
+ */
+import { spawn } from "node:child_process";
+import { openSync, readSync, closeSync, statSync, readFileSync } from "node:fs";
+import { magickEnv } from "../thumbs.js";
+/** A pathological source must not wedge a converter for ever. */
+const TOOL_TIMEOUT_MS = 20_000;
+/** Frames bigger than this are not byte-compared — a whole-desktop retina grab
+ *  is ~10 MB and two of them per settle sample is not worth the read. */
+const BYTE_COMPARE_MAX = 24 * 1024 * 1024;
+/**
+ * Below this standard deviation (ImageMagick's `%[fx:standard_deviation]`,
+ * normalised 0–1) a frame is one flat colour: a page that never painted, a
+ * simulator showing its loading fill, a black screen. Not "dark" — dark UI has
+ * text in it, which is variance.
+ */
+export const BLANK_SD = 0.004;
+function run(cmd, args, env) {
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = (v) => { if (!done) {
+            done = true;
+            resolve(v);
+        } };
+        try {
+            const p = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"], ...(env ? { env: { ...process.env, ...env } } : {}) });
+            let out = "", err = "";
+            p.stdout.on("data", (d) => { out += d.toString(); });
+            p.stderr.on("data", (d) => { err += d.toString(); });
+            const timer = setTimeout(() => { try {
+                p.kill("SIGKILL");
+            }
+            catch { /* gone */ } finish(null); }, TOOL_TIMEOUT_MS);
+            p.on("error", () => { clearTimeout(timer); finish(null); });
+            p.on("exit", (code) => { clearTimeout(timer); finish({ code, out, err }); });
+        }
+        catch {
+            finish(null);
+        }
+    });
+}
+let tools = null;
+export async function probePixelTools() {
+    if (tools)
+        return tools;
+    const ok = async (cmd, args) => {
+        const r = await run(cmd, args);
+        return !!r && r.code === 0;
+    };
+    if (await ok("magick", ["-version"])) {
+        tools = { identify: ["magick", "identify"], compare: ["magick", "compare"] };
+    }
+    else {
+        tools = {
+            identify: (await ok("identify", ["-version"])) ? ["identify"] : null,
+            // IM6's `compare` exits 1 on "the images differ", which is the NORMAL
+            // outcome — so its presence is probed with `-version`, which exits 0.
+            compare: (await ok("compare", ["-version"])) ? ["compare"] : null,
+        };
+    }
+    return tools;
+}
+/** One human sentence naming what is missing, for `diff.reason`. */
+export function pixelToolReason(t) {
+    return t.compare
+        ? "measured with ImageMagick"
+        : "no pixel tool on this machine (install ImageMagick for a measured difference)";
+}
+/**
+ * Are these two frames the same bytes?
+ *
+ * The settle check. No tool, no decode, no approximation: PNG encoders are
+ * deterministic, so an unchanged screen round-trips to an identical file. A
+ * `false` here is never "probably moved" — it is "these files differ", which on
+ * a noisy capture path (a desktop grab with a blinking cursor in it) is the
+ * honest answer and simply means the run keeps sampling until its cap.
+ */
+export function framesIdentical(a, b) {
+    try {
+        const sa = statSync(a), sb = statSync(b);
+        if (sa.size !== sb.size)
+            return false;
+        if (sa.size > BYTE_COMPARE_MAX)
+            return false;
+        return readFileSync(a).equals(readFileSync(b));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Geometry, out of the PNG's own IHDR chunk.
+ *
+ * A 24-byte header read, not an image library: the signature and then two
+ * big-endian uint32s at a fixed offset. `null` when the file is not a PNG or is
+ * truncated — which is exactly the `window`-backend case the sidecar's optional
+ * `viewport` exists for, and the verdict's `n/a` arm prints.
+ */
+export function pngSize(path) {
+    let fd = -1;
+    try {
+        fd = openSync(path, "r");
+        const buf = Buffer.alloc(24);
+        if (readSync(fd, buf, 0, 24, 0) < 24)
+            return null;
+        if (buf.readUInt32BE(0) !== 0x89504e47)
+            return null; // \x89PNG
+        if (buf.toString("latin1", 12, 16) !== "IHDR")
+            return null;
+        const w = buf.readUInt32BE(16), h = buf.readUInt32BE(20);
+        if (!w || !h || w > 100_000 || h > 100_000)
+            return null;
+        return { w, h };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (fd >= 0) {
+            try {
+                closeSync(fd);
+            }
+            catch { /* gone */ }
+        }
+    }
+}
+/**
+ * How flat this frame is, 0 (one solid colour) to ~1. `null` with no tool.
+ *
+ * Never turned into a boolean here: the caller compares against `BLANK_SD` and
+ * an absent reading means the blank check did not run, which the verdict says
+ * rather than guessing "not blank".
+ */
+export async function blankVariance(path) {
+    const t = await probePixelTools();
+    if (!t.identify)
+        return null;
+    // No policed environment: absent, never an unpoliced identify (`thumbs.ts`).
+    const env = magickEnv();
+    if (!env)
+        return null;
+    const [bin, ...pre] = t.identify;
+    const r = await run(bin, [...pre, "-format", "%[fx:standard_deviation]", `png:${path}`], env);
+    if (!r || r.code !== 0)
+        return null;
+    const n = Number(r.out.trim().split(/\s+/)[0]);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Percent of pixels that differ between two frames, or `null` when nothing here
+ * could measure it.
+ *
+ * `compare -metric AE` counts absolutely-different pixels and prints the count
+ * on STDERR; it exits 1 when the images differ, which is the expected outcome
+ * and not an error. Exit 2 (different geometry, unreadable file) is a real
+ * failure and comes back `null` — a resized window is not "0% changed".
+ */
+export async function changedPct(a, b) {
+    if (framesIdentical(a, b))
+        return 0;
+    const t = await probePixelTools();
+    if (!t.compare)
+        return null;
+    const size = pngSize(a);
+    const other = pngSize(b);
+    if (!size || !other || size.w !== other.w || size.h !== other.h)
+        return null;
+    const [bin, ...pre] = t.compare;
+    const r = await run(bin, [...pre, "-metric", "AE", a, b, "null:"]);
+    if (!r || (r.code !== 0 && r.code !== 1))
+        return null;
+    const m = /(\d+(?:\.\d+)?)/.exec(r.err.trim() || r.out.trim());
+    if (!m)
+        return null;
+    const diff = Number(m[1]);
+    const total = size.w * size.h;
+    if (!Number.isFinite(diff) || total <= 0)
+        return null;
+    return Math.round((diff / total) * 1000) / 10;
+}
+//# sourceMappingURL=pixels.js.map

package/packages/host/dist/capture/pixels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixels.js","sourceRoot":"","sources":["../../src/capture/pixels.ts"],"names":[],"mappings":"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"}