hirmos 1.3.1 → 1.3.3

package/README.md

@@ -61,6 +61,23 @@ Disable remote download and require an existing `_hirmos/` or local `--source`:
 hirmos init --offline
 ```
 
+## CLI update notice
+
+When `hirmos init` runs online, it checks whether a newer published HIRMOS CLI version is available on npm. If a newer version exists, the CLI prints a non-blocking message such as:
+
+```text
+A newer HIRMOS CLI is available: 1.3.3.
+Update with: npm install -g hirmos@latest
+```
+
+The notice does not stop initialization. Network failures, registry errors, or timeouts are ignored.
+
+Use `--offline` to disable both remote framework download and the update check. To disable only the update notice while keeping remote framework download available, run:
+
+```bash
+HIRMOS_CLI_UPDATE_CHECK=0 hirmos init
+```
+
 ## Supported integrations
 
 ```text

package/dist/commands/init.js

@@ -58,7 +58,16 @@ function formatInitSummary(first, selected, added, alreadyInstalled, targets, in
         for (const target of targets)
             lines.push(`- ${target}`);
         lines.push("", "Next step:");
-        lines.push("Open your AI coding tool and ask it to read and follow _hirmos/HIRMOS_CORE.md.");
+        lines.push("Open your AI coding tool in this project and run a HIRMOS workflow command, for example:");
+        lines.push("");
+        lines.push("hirmos requirements");
+        lines.push("hirmos system-design");
+        lines.push("hirmos implementation");
+        lines.push("");
+        lines.push("Fallback initialization:");
+        lines.push("If your tool does not automatically pick up the selected agent/tool integration files, copy and paste this prompt into your agent:");
+        lines.push("");
+        lines.push("Read and follow the instructions on _hirmos/HIRMOS_CORE.md.");
         lines.push("", "To add more integrations later:");
         lines.push("hirmos init --integration claude,cursor,copilot");
         return `${lines.join("\n")}\n`;

package/dist/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const args_1 = require("./lib/args");
 const errors_1 = require("./lib/errors");
 const init_1 = require("./commands/init");
+const update_notice_1 = require("./lib/update-notice");
 function main() {
     try {
         const parsed = (0, args_1.parseArgs)(process.argv.slice(2));
@@ -12,6 +13,13 @@ function main() {
             return;
         }
         if (parsed.command === "init") {
+            if (!parsed.offline) {
+                const updateNotice = (0, update_notice_1.getUpdateNotice)();
+                if (updateNotice)
+                    process.stderr.write(`${(0, update_notice_1.formatUpdateNotice)(updateNotice)}
+
+`);
+            }
             const summary = (0, init_1.runInit)({
                 projectPath: parsed.projectPath,
                 integrations: parsed.integrations,

package/dist/lib/update-notice.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInstalledCliVersion = getInstalledCliVersion;
+exports.normalizeSemver = normalizeSemver;
+exports.compareSemver = compareSemver;
+exports.buildUpdateNotice = buildUpdateNotice;
+exports.formatUpdateNotice = formatUpdateNotice;
+exports.getLatestPublishedVersion = getLatestPublishedVersion;
+exports.getUpdateNotice = getUpdateNotice;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const PACKAGE_NAME = "hirmos";
+const DEFAULT_TIMEOUT_MS = 1500;
+const ANSI_BOLD = "\u001b[1m";
+const ANSI_YELLOW = "\u001b[33m";
+const ANSI_RESET = "\u001b[0m";
+function getInstalledCliVersion(cliRoot = path_1.default.resolve(__dirname, "../..")) {
+    try {
+        const packageJsonPath = path_1.default.join(cliRoot, "package.json");
+        const raw = fs_1.default.readFileSync(packageJsonPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeSemver(value) {
+    return value.trim().replace(/^v/u, "").split("-")[0];
+}
+function compareSemver(left, right) {
+    const leftParts = normalizeSemver(left).split(".").map((part) => Number.parseInt(part, 10));
+    const rightParts = normalizeSemver(right).split(".").map((part) => Number.parseInt(part, 10));
+    for (let i = 0; i < 3; i += 1) {
+        const leftValue = Number.isFinite(leftParts[i]) ? leftParts[i] : 0;
+        const rightValue = Number.isFinite(rightParts[i]) ? rightParts[i] : 0;
+        if (leftValue > rightValue)
+            return 1;
+        if (leftValue < rightValue)
+            return -1;
+    }
+    return 0;
+}
+function buildUpdateNotice(currentVersion, latestVersion) {
+    if (!currentVersion || !latestVersion)
+        return null;
+    if (compareSemver(latestVersion, currentVersion) <= 0)
+        return null;
+    return `A newer HIRMOS CLI is available: ${latestVersion}.\nUpdate with: npm install -g ${PACKAGE_NAME}@latest`;
+}
+function formatUpdateNotice(message, useColor = Boolean(process.stderr.isTTY) && process.env.NO_COLOR === undefined) {
+    return useColor ? `${ANSI_BOLD}${ANSI_YELLOW}${message}${ANSI_RESET}` : message;
+}
+function getLatestPublishedVersion(timeoutMs = DEFAULT_TIMEOUT_MS) {
+    if (process.env.HIRMOS_CLI_UPDATE_CHECK === "0" || process.env.HIRMOS_NO_UPDATE_CHECK === "1") {
+        return null;
+    }
+    try {
+        const result = (0, child_process_1.spawnSync)("npm", ["view", PACKAGE_NAME, "version", "--silent"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: timeoutMs
+        });
+        if (result.error || result.status !== 0)
+            return null;
+        const version = String(result.stdout ?? "").trim();
+        return /^v?\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?$/u.test(version) ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function getUpdateNotice() {
+    return buildUpdateNotice(getInstalledCliVersion(), getLatestPublishedVersion());
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hirmos",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "HIRMOS product-facing CLI.",
   "license": "Apache-2.0",
   "type": "commonjs",