@sentropic/h2a-cli 0.74.0 → 0.78.0

package/dist/runtime/upgrade/index.d.ts

@@ -1,96 +0,0 @@
-/**
- * DEC-107 — EVO-8: CLI auto-upgrade. Three levels:
- *  (1) `h2a upgrade [--check]` — explicit, user-invoked;
- *  (2) `mcp-serve` boot version-check notice — non-blocking, cached, opt-out;
- *  (3) `mcp-serve --auto-upgrade` — self-install `@latest` at boot (the new
- *      version applies on the NEXT launch — a running Node process cannot
- *      replace its own binary in flight).
- *
- * Pure version logic + an injectable `UpgradeRuntime` (network/exec/clock/cache)
- * so everything is testable without npm or the network.
- */
-export declare const H2A_CLI_PACKAGE = "@sentropic/h2a-cli";
-/** Re-check at most once per this window for the passive `--upgrade-check` notice. */
-export declare const H2A_UPGRADE_CHECK_TTL_MS: number;
-/**
- * Shorter throttle for `--auto-upgrade`: it is opt-in to *stay current*, so a
- * 24h notice cache must not make it lag a same-day release (the bug that left
- * agents on 0.39.0 after a restart). 1h still dedups a mass restart through the
- * shared per-root cache (only the first booting host hits the network).
- */
-export declare const H2A_AUTO_UPGRADE_CHECK_TTL_MS: number;
-/** Parse a strict X.Y.Z triple, or undefined if it is not one. */
-export declare function parseSemver(v: string): {
-    major: number;
-    minor: number;
-    patch: number;
-} | undefined;
-/** True iff `latest` is a strictly higher X.Y.Z than `current`. */
-export declare function isNewerVersion(latest: string, current: string): boolean;
-/** The version of the running `@sentropic/h2a-cli` (from its package.json). */
-export declare function currentCliVersion(): string;
-export interface UpgradeCacheEntry {
-    readonly checkedAt: number;
-    readonly latest?: string;
-}
-/** I/O the upgrade flow needs — injected so tests supply fakes. */
-export interface UpgradeRuntime {
-    /** Latest published version of `pkg`, or undefined on any failure. */
-    fetchLatest(pkg: string): string | undefined;
-    /** `npm i -g pkg@latest`; true on success. */
-    runInstall(pkg: string): boolean;
-    now(): number;
-    readCache(path: string): UpgradeCacheEntry | undefined;
-    writeCache(path: string, entry: UpgradeCacheEntry): void;
-}
-export declare const defaultUpgradeRuntime: UpgradeRuntime;
-export interface UpgradeCheckResult {
-    readonly current: string;
-    readonly latest?: string;
-    readonly upgradeAvailable: boolean;
-    /** True if the latest came from a fresh cache hit (no network this call). */
-    readonly fromCache: boolean;
-}
-export interface CheckUpgradeOptions {
-    readonly runtime?: UpgradeRuntime;
-    /** Cache file path; when set, a fresh entry within TTL skips the network. */
-    readonly cachePath?: string;
-    readonly ttlMs?: number;
-    /** Skip the cache entirely (always hit the network). */
-    readonly force?: boolean;
-}
-/**
- * Determine whether a newer CLI is published. Cached + throttled when a
- * `cachePath` is given (level-2 boot notice); always-fresh otherwise. Never
- * throws — a network failure yields `{ latest: undefined, upgradeAvailable:false }`.
- */
-export declare function checkUpgrade(current: string, options?: CheckUpgradeOptions): UpgradeCheckResult;
-/** Run the global install of `@latest`. Returns true on success. */
-export declare function performUpgrade(runtime?: UpgradeRuntime): boolean;
-/** Default cache path for the boot check, under the store root. */
-export declare function upgradeCachePath(root: string): string;
-/**
- * Env flag set across an in-place re-exec so the freshly-exec'd process does
- * NOT auto-upgrade + re-exec again this boot (breaks any pathological loop if
- * an install reports success without changing the on-disk version).
- */
-export declare const H2A_REEXEC_GUARD_ENV = "H2A_UPGRADE_REEXECED";
-export interface ReexecOptions {
-    /** Injectable for tests; defaults to `process.execve` when present. */
-    readonly execve?: (file: string, args: readonly string[], env: Record<string, string | undefined>) => never;
-    readonly execPath?: string;
-    readonly argv?: readonly string[];
-    readonly env?: Record<string, string | undefined>;
-}
-/** True when an in-place re-exec is possible (POSIX `process.execve`, Node ≥ 23.10). */
-export declare function canReexec(): boolean;
-/**
- * Re-exec the current process into the (just-upgraded) binary at the SAME path,
- * preserving PID + stdio fds — so a host-spawned `mcp-serve` picks up the new
- * version immediately without the host seeing a disconnect. On success the
- * process image is replaced and this never returns; returns `false` if re-exec
- * is unavailable or failed (caller falls back to "applies next launch"). The
- * `H2A_REEXEC_GUARD_ENV` flag is set so the new image does not re-upgrade.
- */
-export declare function reexecSelf(options?: ReexecOptions): boolean;
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/upgrade/index.d.ts.map

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

package/dist/runtime/upgrade/index.js

@@ -1,185 +0,0 @@
-/**
- * DEC-107 — EVO-8: CLI auto-upgrade. Three levels:
- *  (1) `h2a upgrade [--check]` — explicit, user-invoked;
- *  (2) `mcp-serve` boot version-check notice — non-blocking, cached, opt-out;
- *  (3) `mcp-serve --auto-upgrade` — self-install `@latest` at boot (the new
- *      version applies on the NEXT launch — a running Node process cannot
- *      replace its own binary in flight).
- *
- * Pure version logic + an injectable `UpgradeRuntime` (network/exec/clock/cache)
- * so everything is testable without npm or the network.
- */
-import { spawnSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve as resolvePath } from "node:path";
-import { fileURLToPath } from "node:url";
-export const H2A_CLI_PACKAGE = "@sentropic/h2a-cli";
-/** Re-check at most once per this window for the passive `--upgrade-check` notice. */
-export const H2A_UPGRADE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
-/**
- * Shorter throttle for `--auto-upgrade`: it is opt-in to *stay current*, so a
- * 24h notice cache must not make it lag a same-day release (the bug that left
- * agents on 0.39.0 after a restart). 1h still dedups a mass restart through the
- * shared per-root cache (only the first booting host hits the network).
- */
-export const H2A_AUTO_UPGRADE_CHECK_TTL_MS = 60 * 60 * 1000;
-const STRICT_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
-/** Parse a strict X.Y.Z triple, or undefined if it is not one. */
-export function parseSemver(v) {
-    const m = STRICT_SEMVER.exec(v.trim());
-    if (!m)
-        return undefined;
-    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
-}
-/** True iff `latest` is a strictly higher X.Y.Z than `current`. */
-export function isNewerVersion(latest, current) {
-    const a = parseSemver(latest);
-    const b = parseSemver(current);
-    if (!a || !b)
-        return false;
-    if (a.major !== b.major)
-        return a.major > b.major;
-    if (a.minor !== b.minor)
-        return a.minor > b.minor;
-    return a.patch > b.patch;
-}
-/** The version of the running `@sentropic/h2a-cli` (from its package.json). */
-export function currentCliVersion() {
-    try {
-        const here = dirname(fileURLToPath(import.meta.url)); // dist/runtime/upgrade
-        const pkgPath = resolvePath(here, "..", "..", "..", "package.json");
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
-    }
-    catch {
-        return "0.0.0";
-    }
-}
-export const defaultUpgradeRuntime = {
-    fetchLatest(pkg) {
-        try {
-            // Bounded, but realistic: `npm view` routinely takes ~5s, so the old 4s
-            // timeout fired every time and SILENTLY broke every upgrade check (the
-            // global + all hosts stayed pinned — DEC-114). 15s covers a slow registry;
-            // the boot check is cached (24h TTL) so this network call is rare.
-            const r = spawnSync("npm", ["view", pkg, "version"], { encoding: "utf8", timeout: 15_000 });
-            if (r.status !== 0)
-                return undefined;
-            const v = r.stdout.trim();
-            return parseSemver(v) ? v : undefined;
-        }
-        catch {
-            return undefined;
-        }
-    },
-    runInstall(pkg) {
-        try {
-            const r = spawnSync("npm", ["i", "-g", `${pkg}@latest`], { stdio: "ignore", timeout: 120_000 });
-            return r.status === 0;
-        }
-        catch {
-            return false;
-        }
-    },
-    now() {
-        return Date.now();
-    },
-    readCache(path) {
-        try {
-            if (!existsSync(path))
-                return undefined;
-            return JSON.parse(readFileSync(path, "utf8"));
-        }
-        catch {
-            return undefined;
-        }
-    },
-    writeCache(path, entry) {
-        try {
-            writeFileSync(path, `${JSON.stringify(entry, null, 2)}\n`, "utf8");
-        }
-        catch {
-            // best-effort
-        }
-    }
-};
-/**
- * Determine whether a newer CLI is published. Cached + throttled when a
- * `cachePath` is given (level-2 boot notice); always-fresh otherwise. Never
- * throws — a network failure yields `{ latest: undefined, upgradeAvailable:false }`.
- */
-export function checkUpgrade(current, options = {}) {
-    const runtime = options.runtime ?? defaultUpgradeRuntime;
-    const ttlMs = options.ttlMs ?? H2A_UPGRADE_CHECK_TTL_MS;
-    const now = runtime.now();
-    if (options.cachePath && !options.force) {
-        const cached = runtime.readCache(options.cachePath);
-        if (cached && now - cached.checkedAt < ttlMs) {
-            return {
-                current,
-                ...(cached.latest ? { latest: cached.latest } : {}),
-                upgradeAvailable: cached.latest ? isNewerVersion(cached.latest, current) : false,
-                fromCache: true
-            };
-        }
-    }
-    const latest = runtime.fetchLatest(H2A_CLI_PACKAGE);
-    if (options.cachePath) {
-        runtime.writeCache(options.cachePath, { checkedAt: now, ...(latest ? { latest } : {}) });
-    }
-    return {
-        current,
-        ...(latest ? { latest } : {}),
-        upgradeAvailable: latest ? isNewerVersion(latest, current) : false,
-        fromCache: false
-    };
-}
-/** Run the global install of `@latest`. Returns true on success. */
-export function performUpgrade(runtime = defaultUpgradeRuntime) {
-    return runtime.runInstall(H2A_CLI_PACKAGE);
-}
-/** Default cache path for the boot check, under the store root. */
-export function upgradeCachePath(root) {
-    return join(root, "upgrade-check.json");
-}
-/**
- * Env flag set across an in-place re-exec so the freshly-exec'd process does
- * NOT auto-upgrade + re-exec again this boot (breaks any pathological loop if
- * an install reports success without changing the on-disk version).
- */
-export const H2A_REEXEC_GUARD_ENV = "H2A_UPGRADE_REEXECED";
-/** True when an in-place re-exec is possible (POSIX `process.execve`, Node ≥ 23.10). */
-export function canReexec() {
-    return typeof process.execve === "function";
-}
-/**
- * Re-exec the current process into the (just-upgraded) binary at the SAME path,
- * preserving PID + stdio fds — so a host-spawned `mcp-serve` picks up the new
- * version immediately without the host seeing a disconnect. On success the
- * process image is replaced and this never returns; returns `false` if re-exec
- * is unavailable or failed (caller falls back to "applies next launch"). The
- * `H2A_REEXEC_GUARD_ENV` flag is set so the new image does not re-upgrade.
- */
-export function reexecSelf(options = {}) {
-    const execve = options.execve ??
-        process.execve;
-    if (typeof execve !== "function")
-        return false;
-    const execPath = options.execPath ?? process.execPath;
-    // CRITICAL: a failing `process.execve` (e.g. a bad path) aborts the process
-    // *natively* — it is NOT a catchable throw — so we must not call it on a
-    // target that might fail. Guard on existence first; the real boot path uses
-    // `process.execPath` (the running node), which is always valid.
-    if (!existsSync(execPath))
-        return false;
-    const argv = options.argv ?? process.argv.slice(1);
-    const env = { ...(options.env ?? process.env), [H2A_REEXEC_GUARD_ENV]: "1" };
-    try {
-        execve(execPath, [execPath, ...argv], env);
-        return true; // unreachable when execve truly replaces the image
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/runtime/upgrade/index.js.map

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

package/dist/runtime/version/agent-version.d.ts

@@ -1,15 +0,0 @@
-import type { H2AAgentVersion } from "@sentropic/h2a";
-/**
- * Read the `version` stamp from the installed h2a skill for `host`, best-effort.
- * Accepts both YAML frontmatter (`version: x`, SKILL.md) and TOML (`version = "x"`,
- * gemini command file). Returns undefined for an unknown host, a missing/unreadable
- * file, or a skill with no version stamp.
- */
-export declare function readInstalledSkillVersion(host: string, home?: string): string | undefined;
-/**
- * Compose the deployed-version stamp for a session: the running CLI version and
- * (when a host is known) its installed skill version. Fields are omitted rather
- * than set to undefined so the presence record stays clean.
- */
-export declare function agentVersion(host?: string, home?: string): H2AAgentVersion;
-//# sourceMappingURL=agent-version.d.ts.map

package/dist/runtime/version/agent-version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-version.d.ts","sourceRoot":"","sources":["../../../src/runtime/version/agent-version.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYtD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,GAAG,SAAS,CAUpG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,eAAe,CAOrF"}

package/dist/runtime/version/agent-version.js

@@ -1,53 +0,0 @@
-/**
- * Deployed-version visibility (EVO — addressing/version convergence, slice #2).
- *
- * The binary self-upgrades (`mcp-serve --auto-upgrade`) but the **skill does
- * not** — it is copied to each host by `h2a install-skills` and then frozen.
- * So an agent can run a fresh CLI behind a stale skill, invisibly. Stamping
- * `{ cli, skill }` into the presence record at session open makes that drift
- * visible in `/h2a discover` and `h2a doctor` without polling each host.
- */
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { currentCliVersion } from "../upgrade/index.js";
-/** Where each host's installed h2a skill file lives, relative to a home dir. */
-const HOST_SKILL_FILE = {
-    claude: (home) => join(home, ".claude", "skills", "h2a", "SKILL.md"),
-    codex: (home) => join(home, ".codex", "skills", "h2a", "SKILL.md"),
-    gemini: (home) => join(home, ".gemini", "commands", "h2a.toml"),
-    agy: (home) => join(home, ".gemini", "commands", "h2a.toml")
-};
-/**
- * Read the `version` stamp from the installed h2a skill for `host`, best-effort.
- * Accepts both YAML frontmatter (`version: x`, SKILL.md) and TOML (`version = "x"`,
- * gemini command file). Returns undefined for an unknown host, a missing/unreadable
- * file, or a skill with no version stamp.
- */
-export function readInstalledSkillVersion(host, home = homedir()) {
-    const resolve = HOST_SKILL_FILE[host];
-    if (!resolve)
-        return undefined;
-    try {
-        const raw = readFileSync(resolve(home), "utf8");
-        const match = /^\s*version\s*[:=]\s*["']?(\d+\.\d+\.\d+[^"'\s]*)/m.exec(raw);
-        return match ? match[1] : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Compose the deployed-version stamp for a session: the running CLI version and
- * (when a host is known) its installed skill version. Fields are omitted rather
- * than set to undefined so the presence record stays clean.
- */
-export function agentVersion(host, home = homedir()) {
-    const cli = currentCliVersion();
-    const skill = host ? readInstalledSkillVersion(host, home) : undefined;
-    return {
-        ...(cli ? { cli } : {}),
-        ...(skill ? { skill } : {})
-    };
-}
-//# sourceMappingURL=agent-version.js.map

package/dist/runtime/version/agent-version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-version.js","sourceRoot":"","sources":["../../../src/runtime/version/agent-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,gFAAgF;AAChF,MAAM,eAAe,GAA6C;IAChE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC;IACpE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC;IAClE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC;CAC7D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,OAAe,OAAO,EAAE;IAC9E,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,oDAAoD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,OAAe,OAAO,EAAE;IAClE,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,OAAO;QACL,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}