@hmharness/cli 0.1.0

package/dist/web-daemon.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_WEB_PORT = 7788;
+export declare function readWebPid(): number;
+/** cheap probe: does OUR server answer on the port (not just any listener)? */
+export declare function hmhWebUp(port: number): Promise<boolean>;
+export declare function stopWebDaemon(): boolean;
+/**
+ * Idempotent: if our web UI is already up (pid file alive, or the port
+ * answers as hmh), keep it; otherwise spawn it and wait up to ~6s for
+ * readiness. Returns true when the web UI is usable.
+ */
+export declare function ensureWebDaemon(port?: number, entry?: string): Promise<boolean>;
+export declare function startWebDaemon(port?: number, entry?: string): {
+    already: boolean;
+    pid: number;
+};

package/dist/web-daemon.js

@@ -0,0 +1,106 @@
+/**
+ * @hmharness/cli - web daemon helpers
+ * Shared by `hmh web start|stop|status` and the TUI auto-link (hmh tui
+ * brings the web UI up unless --no-web). One pid file + one log file under
+ * HMH_HOME; the daemon runs detached with no window and survives terminals.
+ */
+import { spawn } from 'node:child_process';
+import { openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homeDir } from '@hmharness/kernel';
+export const DEFAULT_WEB_PORT = 7788;
+export function readWebPid() {
+    try {
+        const p = Number(readFileSync(join(homeDir(), 'web.pid'), 'utf8').trim());
+        return Number.isFinite(p) && p > 0 ? p : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** cheap probe: does OUR server answer on the port (not just any listener)? */
+export async function hmhWebUp(port) {
+    try {
+        const r = await fetch(`http://127.0.0.1:${port}/api/state`, { signal: AbortSignal.timeout(1500) });
+        if (!r.ok)
+            return false;
+        const d = (await r.json());
+        return typeof d.model === 'string';
+    }
+    catch {
+        return false;
+    }
+}
+export function stopWebDaemon() {
+    const pid = readWebPid();
+    if (!pid || !alive(pid)) {
+        try {
+            unlinkSync(join(homeDir(), 'web.pid'));
+        }
+        catch { /* absent */ }
+        return false;
+    }
+    if (process.platform === 'win32')
+        spawn('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true });
+    else {
+        try {
+            process.kill(pid);
+        }
+        catch { /* gone */ }
+    }
+    try {
+        unlinkSync(join(homeDir(), 'web.pid'));
+    }
+    catch { /* absent */ }
+    return true;
+}
+/** Spawn the daemon (no window, detached). Returns the pid. */
+function spawnWebDaemon(port, entry = process.argv[1]) {
+    const home = homeDir();
+    const log = openSync(join(home, 'web.log'), 'a');
+    const child = spawn(process.execPath, [entry, 'web', `--port=${port}`], {
+        detached: true,
+        stdio: ['ignore', log, log],
+        windowsHide: true,
+        cwd: process.cwd(),
+    });
+    child.unref();
+    const pid = child.pid ?? 0;
+    if (pid > 0)
+        writeFileSync(join(home, 'web.pid'), String(pid));
+    return pid;
+}
+/**
+ * Idempotent: if our web UI is already up (pid file alive, or the port
+ * answers as hmh), keep it; otherwise spawn it and wait up to ~6s for
+ * readiness. Returns true when the web UI is usable.
+ */
+export async function ensureWebDaemon(port = DEFAULT_WEB_PORT, entry = process.argv[1]) {
+    const pid = readWebPid();
+    if (pid && alive(pid))
+        return true;
+    if (await hmhWebUp(port))
+        return true;
+    spawnWebDaemon(port, entry);
+    for (let i = 0; i < 12; i++) {
+        await new Promise((r) => setTimeout(r, 500));
+        if (await hmhWebUp(port))
+            return true;
+    }
+    return false;
+}
+export function startWebDaemon(port = DEFAULT_WEB_PORT, entry = process.argv[1]) {
+    const pid = readWebPid();
+    if (pid && alive(pid))
+        return { already: true, pid };
+    return { already: false, pid: spawnWebDaemon(port, entry) };
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hmharness/cli",
+  "version": "0.1.0",
+  "description": "hmharness command line: one-shot tasks, an interactive REPL, a fullscreen TUI, the web frontend, and direct tool invocation.",
+  "type": "module",
+  "main": "dist/main.js",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    }
+  },
+  "types": "dist/main.d.ts",
+  "bin": {
+    "hmh": "./dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "harmonyos",
+    "openharmony",
+    "ohos",
+    "agent",
+    "ai",
+    "cli",
+    "coding-agent",
+    "arkts",
+    "self-evolving",
+    "mcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swsgbl/hmharness.git"
+  },
+  "homepage": "https://swsgbl.github.io/hmharness/",
+  "bugs": "https://github.com/swsgbl/hmharness/issues",
+  "license": "Apache-2.0",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@hmharness/kernel": "0.1.0",
+    "@hmharness/evolution": "0.1.0",
+    "@hmharness/domain-harmony": "0.1.0",
+    "@hmharness/domain-ops": "0.1.0",
+    "@hmharness/agent": "0.1.0",
+    "@hmharness/web": "0.1.0"
+  }
+}