@ia-qa/self-healing 1.6.6 → 1.6.8

package/dist/ui/icon.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The console's desktop icon.
+ *
+ * Windows will not take a PNG for a shortcut's `IconLocation` — it wants an
+ * `.ico`, an `.exe` or a `.dll`. Converting an image normally means a native
+ * encoder, which this package will not take on: `sharp`/`jimp` for one desktop
+ * icon would be a heavier dependency than the entire tool.
+ *
+ * It does not need one. Since Vista, an ICO entry may hold a **PNG verbatim**
+ * instead of a BMP, so the conversion is a 22-byte header wrapped around bytes
+ * we already have. No decoding, no re-encoding, no dependency, and the result
+ * is byte-identical every run.
+ *
+ * Layout, all little-endian:
+ *
+ *   ICONDIR       6 bytes   reserved=0, type=1 (icon), count
+ *   ICONDIRENTRY 16 bytes   w, h, palette=0, reserved=0, planes=1, bpp=32,
+ *                           byteLength, offset
+ *   …the PNG file itself
+ */
+export declare const ICO_HEADER_BYTES = 22;
+/** Width/height from a PNG's IHDR, which is always the first chunk. */
+export declare function pngSize(png: Buffer): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * Wrap a PNG in an ICO container. Returns null for anything that is not a PNG,
+ * rather than producing a file Windows would silently refuse to draw.
+ *
+ * A dimension of 256 is written as 0 — that is the format's own convention for
+ * "256", and it is why sizes above 256 cannot be expressed at all.
+ */
+export declare function pngToIco(png: Buffer): Buffer | null;
+/**
+ * The brand logo shipped in the tarball. `assets/` must stay in package.json →
+ * `files` or this resolves to a path that only exists in the repo — the same
+ * trap `skills/` has (a test pins both).
+ */
+export declare function brandLogoPath(): string;
+export declare function readBrandLogo(): Buffer | null;

package/dist/ui/icon.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ICO_HEADER_BYTES = void 0;
+exports.pngSize = pngSize;
+exports.pngToIco = pngToIco;
+exports.brandLogoPath = brandLogoPath;
+exports.readBrandLogo = readBrandLogo;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * The console's desktop icon.
+ *
+ * Windows will not take a PNG for a shortcut's `IconLocation` — it wants an
+ * `.ico`, an `.exe` or a `.dll`. Converting an image normally means a native
+ * encoder, which this package will not take on: `sharp`/`jimp` for one desktop
+ * icon would be a heavier dependency than the entire tool.
+ *
+ * It does not need one. Since Vista, an ICO entry may hold a **PNG verbatim**
+ * instead of a BMP, so the conversion is a 22-byte header wrapped around bytes
+ * we already have. No decoding, no re-encoding, no dependency, and the result
+ * is byte-identical every run.
+ *
+ * Layout, all little-endian:
+ *
+ *   ICONDIR       6 bytes   reserved=0, type=1 (icon), count
+ *   ICONDIRENTRY 16 bytes   w, h, palette=0, reserved=0, planes=1, bpp=32,
+ *                           byteLength, offset
+ *   …the PNG file itself
+ */
+exports.ICO_HEADER_BYTES = 22;
+/** Width/height from a PNG's IHDR, which is always the first chunk. */
+function pngSize(png) {
+    const SIGNATURE = '89504e470d0a1a0a';
+    if (png.length < 24 || png.subarray(0, 8).toString('hex') !== SIGNATURE)
+        return null;
+    return { width: png.readUInt32BE(16), height: png.readUInt32BE(20) };
+}
+/**
+ * Wrap a PNG in an ICO container. Returns null for anything that is not a PNG,
+ * rather than producing a file Windows would silently refuse to draw.
+ *
+ * A dimension of 256 is written as 0 — that is the format's own convention for
+ * "256", and it is why sizes above 256 cannot be expressed at all.
+ */
+function pngToIco(png) {
+    const size = pngSize(png);
+    if (!size)
+        return null;
+    if (size.width > 256 || size.height > 256)
+        return null;
+    const header = Buffer.alloc(exports.ICO_HEADER_BYTES);
+    header.writeUInt16LE(0, 0); // reserved
+    header.writeUInt16LE(1, 2); // type: icon
+    header.writeUInt16LE(1, 4); // one image
+    header.writeUInt8(size.width === 256 ? 0 : size.width, 6);
+    header.writeUInt8(size.height === 256 ? 0 : size.height, 7);
+    header.writeUInt8(0, 8); // palette colours: none, it is truecolour
+    header.writeUInt8(0, 9); // reserved
+    header.writeUInt16LE(1, 10); // colour planes
+    header.writeUInt16LE(32, 12); // bits per pixel
+    header.writeUInt32LE(png.length, 14);
+    header.writeUInt32LE(exports.ICO_HEADER_BYTES, 18);
+    return Buffer.concat([header, png]);
+}
+/**
+ * The brand logo shipped in the tarball. `assets/` must stay in package.json →
+ * `files` or this resolves to a path that only exists in the repo — the same
+ * trap `skills/` has (a test pins both).
+ */
+function brandLogoPath() {
+    // dist/ui/icon.js → package root
+    return path.join(__dirname, '..', '..', 'assets', 'logoKawaiiGreenTiny.png');
+}
+function readBrandLogo() {
+    try {
+        return fs.readFileSync(brandLogoPath());
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=icon.js.map

package/dist/ui/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/ui/icon.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,0BAIC;AASD,4BAkBC;AAOD,sCAGC;AAED,sCAMC;AA5ED,uCAAyB;AACzB,2CAA6B;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AAEU,QAAA,gBAAgB,GAAG,EAAE,CAAC;AAEnC,uEAAuE;AACvE,SAAgB,OAAO,CAAC,GAAW;IACjC,MAAM,SAAS,GAAG,kBAAkB,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrF,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAgB,CAAC,CAAC;IAC9C,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;IACvC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa;IACzC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;IACxC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,0CAA0C;IACnE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;IACpC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB;IAC7C,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB;IAC/C,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,wBAAgB,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,iCAAiC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,aAAa;IAC3B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/ui/lock.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Who is already serving this project's console — `.ia-qa/ui.lock`.
+ *
+ * The console is opened by clicking something, and people click twice. Without
+ * this, the second click either fails on a port collision or starts a *second*
+ * server with a *different* token, leaving an orphan process and a browser tab
+ * that will 401 the moment the first one is closed. Neither is explicable to
+ * the person who clicked.
+ *
+ * So the lock holds the port and the token, and a launcher that finds a live
+ * console simply opens it. The file is a hint, never an authority: it is
+ * verified by an actual request before being believed (a lock left behind by a
+ * killed process is the normal case, not the exception), and it lives next to
+ * the contracts because that is what it is scoped to — one console per project
+ * directory, not one per machine.
+ *
+ * It holds a session token, so it is a file to gitignore, like `_shots/`.
+ */
+export declare const UI_LOCK_FILENAME = "ui.lock";
+export interface UiLock {
+    port: number;
+    token: string;
+    pid: number;
+    startedAt: string;
+}
+export declare function lockPath(cwd?: string): string;
+export declare function writeLock(lock: UiLock): void;
+export declare function clearLock(): void;
+export declare function readLock(): UiLock | null;
+/**
+ * Is the console named by the lock actually answering?
+ *
+ * Checked with a real request rather than by testing whether the pid exists: a
+ * pid can be reused, and what matters is not that *something* is alive but that
+ * it is a console that accepts this token. Short timeout — this runs before a
+ * human sees anything, so a stale lock must not cost them a visible pause.
+ */
+export declare function probe(lock: UiLock, timeoutMs?: number): Promise<boolean>;
+/** The URL of a console already serving this project, or null. */
+export declare function findRunningConsole(): Promise<string | null>;

package/dist/ui/lock.js

@@ -0,0 +1,138 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UI_LOCK_FILENAME = void 0;
+exports.lockPath = lockPath;
+exports.writeLock = writeLock;
+exports.clearLock = clearLock;
+exports.readLock = readLock;
+exports.probe = probe;
+exports.findRunningConsole = findRunningConsole;
+const fs = __importStar(require("fs"));
+const http = __importStar(require("http"));
+const path = __importStar(require("path"));
+const config_1 = require("../config");
+/**
+ * Who is already serving this project's console — `.ia-qa/ui.lock`.
+ *
+ * The console is opened by clicking something, and people click twice. Without
+ * this, the second click either fails on a port collision or starts a *second*
+ * server with a *different* token, leaving an orphan process and a browser tab
+ * that will 401 the moment the first one is closed. Neither is explicable to
+ * the person who clicked.
+ *
+ * So the lock holds the port and the token, and a launcher that finds a live
+ * console simply opens it. The file is a hint, never an authority: it is
+ * verified by an actual request before being believed (a lock left behind by a
+ * killed process is the normal case, not the exception), and it lives next to
+ * the contracts because that is what it is scoped to — one console per project
+ * directory, not one per machine.
+ *
+ * It holds a session token, so it is a file to gitignore, like `_shots/`.
+ */
+exports.UI_LOCK_FILENAME = 'ui.lock';
+function lockPath(cwd = (0, config_1.baseDir)()) {
+    return path.join(cwd, config_1.CONFIG_DIR, exports.UI_LOCK_FILENAME);
+}
+function writeLock(lock) {
+    try {
+        fs.mkdirSync(path.dirname(lockPath()), { recursive: true });
+        // 0600: it carries the session token, and the console it unlocks can edit
+        // test files. On Windows the mode is advisory, which is why the token is
+        // random per process and dies with it rather than being a stored secret.
+        fs.writeFileSync(lockPath(), JSON.stringify(lock), { encoding: 'utf8', mode: 0o600 });
+    }
+    catch {
+        /* a console that cannot write its lock still works; it just cannot be found */
+    }
+}
+function clearLock() {
+    try {
+        fs.unlinkSync(lockPath());
+    }
+    catch {
+        /* already gone */
+    }
+}
+function readLock() {
+    try {
+        const raw = JSON.parse(fs.readFileSync(lockPath(), 'utf8'));
+        if (!Number.isInteger(raw.port) || typeof raw.token !== 'string' || raw.token === '')
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Is the console named by the lock actually answering?
+ *
+ * Checked with a real request rather than by testing whether the pid exists: a
+ * pid can be reused, and what matters is not that *something* is alive but that
+ * it is a console that accepts this token. Short timeout — this runs before a
+ * human sees anything, so a stale lock must not cost them a visible pause.
+ */
+function probe(lock, timeoutMs = 700) {
+    return new Promise((resolve) => {
+        const req = http.get({
+            host: '127.0.0.1',
+            port: lock.port,
+            path: `/api/state?t=${encodeURIComponent(lock.token)}`,
+            timeout: timeoutMs,
+            headers: { Host: `127.0.0.1:${lock.port}` },
+        }, (res) => {
+            res.resume();
+            resolve(res.statusCode === 200);
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(false);
+        });
+        req.on('error', () => resolve(false));
+    });
+}
+/** The URL of a console already serving this project, or null. */
+async function findRunningConsole() {
+    const lock = readLock();
+    if (!lock)
+        return null;
+    if (!(await probe(lock))) {
+        clearLock();
+        return null;
+    }
+    return `http://127.0.0.1:${lock.port}/?t=${lock.token}`;
+}
+//# sourceMappingURL=lock.js.map

package/dist/ui/lock.js.map

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

package/dist/ui/page.d.ts

@@ -0,0 +1 @@
+export declare function renderConsoleHtml(token: string): string;