gaslighting-engine 0.1.0 → 0.1.1

package/README.md

@@ -89,6 +89,32 @@ gaslighting-engine skill
 gaslighting-engine agents
 ```
 
+## Update Notice
+
+Gaslighting-engine checks npm for a newer version when you run normal commands.
+
+If an update exists, it prints a short notice like:
+
+```txt
+Gaslighting-engine update available:
+- current: 0.1.0
+- latest:  0.1.1
+- update:  npm install -g gaslighting-engine@latest
+- npx:     npx gaslighting-engine@latest
+```
+
+The update check is best-effort and never blocks the command. Disable it with:
+
+```bash
+GASLIGHTING_ENGINE_NO_UPDATE_CHECK=1 gaslighting-engine doctor
+```
+
+PowerShell:
+
+```powershell
+$env:GASLIGHTING_ENGINE_NO_UPDATE_CHECK="1"; gaslighting-engine doctor; Remove-Item Env:GASLIGHTING_ENGINE_NO_UPDATE_CHECK
+```
+
 ## Useful Options
 
 Options are escape hatches. The strict behavior is already the default.

package/dist/cli.js

@@ -6,6 +6,7 @@ import { runGenerate } from "./commands/generate.js";
 import { runInit } from "./commands/init.js";
 import { runSkill } from "./commands/skill.js";
 import { runUpdate } from "./commands/update.js";
+import { packageVersion } from "./version.js";
 const projectTypes = [
     "hospital_homepage",
     "ecommerce",
@@ -48,7 +49,7 @@ export function buildCli() {
     program
         .name("gaslighting-engine")
         .description("LUDGI Gaslighting-engine: a hardcore project-discipline generator for AI coding agents.")
-        .version("0.1.0")
+        .version(packageVersion)
         .showHelpAfterError()
         .addHelpText("after", `
 Examples:

package/dist/index.js

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
 import { buildCli, normalizeDefaultInitArgv } from "./cli.js";
+import { notifyIfUpdateAvailable } from "./utils/updateCheck.js";
+await notifyIfUpdateAvailable(process.argv);
 buildCli().parse(normalizeDefaultInitArgv(process.argv));

package/dist/utils/updateCheck.js

@@ -0,0 +1,61 @@
+import { packageName, packageVersion } from "../version.js";
+const updateCheckTimeoutMs = 900;
+export async function notifyIfUpdateAvailable(argv) {
+    if (shouldSkipUpdateCheck(argv))
+        return;
+    try {
+        const latestVersion = process.env.GASLIGHTING_ENGINE_LATEST_VERSION ?? (await fetchLatestVersion());
+        if (!latestVersion || !isNewerVersion(latestVersion, packageVersion))
+            return;
+        console.error("");
+        console.error("Gaslighting-engine update available:");
+        console.error(`- current: ${packageVersion}`);
+        console.error(`- latest:  ${latestVersion}`);
+        console.error(`- update:  npm install -g ${packageName}@latest`);
+        console.error(`- npx:     npx ${packageName}@latest`);
+        console.error("");
+    }
+    catch {
+        // Update checks must never block the user's actual command.
+    }
+}
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), updateCheckTimeoutMs);
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        if (!response.ok)
+            return undefined;
+        const data = (await response.json());
+        return data.version;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function shouldSkipUpdateCheck(argv) {
+    if (process.env.GASLIGHTING_ENGINE_NO_UPDATE_CHECK === "1")
+        return true;
+    if (process.env.NO_UPDATE_NOTIFIER === "1")
+        return true;
+    return argv.some((arg) => ["--help", "-h", "--version", "-V"].includes(arg));
+}
+export function isNewerVersion(candidate, current) {
+    const candidateParts = parseVersion(candidate);
+    const currentParts = parseVersion(current);
+    for (let index = 0; index < 3; index += 1) {
+        if (candidateParts[index] > currentParts[index])
+            return true;
+        if (candidateParts[index] < currentParts[index])
+            return false;
+    }
+    return false;
+}
+function parseVersion(version) {
+    const clean = version.split("-")[0] ?? version;
+    const parts = clean.split(".").map((part) => Number.parseInt(part, 10));
+    return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const packageName = "gaslighting-engine";
+export const packageVersion = "0.1.1";

package/docs/examples.md

@@ -20,3 +20,9 @@ Published usage:
 ```bash
 npx gaslighting-engine "I want to build a hospital website."
 ```
+
+Update check test:
+
+```bash
+GASLIGHTING_ENGINE_LATEST_VERSION=9.9.9 node dist/index.js doctor --path examples/hospital-homepage
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaslighting-engine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "LUDGI Gaslighting-engine: a hardcore project-discipline generator for AI coding agents.",
   "type": "module",
   "license": "MIT",