@sentropic/h2a 0.75.0 → 0.79.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { cmdKeepalive, runCli, runDriveServe, runMcpServe, runRemoteSend, runRemoteServe, runMirrorServe, runMirrorPush, runDrumbeatRelanceInbox, runDrumbeatWatch, runSysmlVerify } from "./cli.js";
+const argv = process.argv.slice(2);
+function parseFlagsFrom(start) {
+    const flags = {};
+    for (let i = start; i < argv.length; i++) {
+        const token = argv[i];
+        if (token.startsWith("--")) {
+            const key = token.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i++;
+            }
+            else {
+                flags[key] = "true";
+            }
+        }
+    }
+    return flags;
+}
+function runAsync(label, promise) {
+    promise.then((rc) => {
+        process.exitCode = rc;
+    }, (err) => {
+        process.stderr.write(`h2a ${label}: fatal: ${err.message}\n`);
+        process.exitCode = 1;
+    });
+}
+// `mcp-serve` and `remote serve/send` are async (long-running loop or network);
+// the synchronous `runCli` cannot represent them, so we dispatch directly here.
+if (argv[0] === "mcp-serve") {
+    // Graceful shutdown: a host kill (or orderly stop) cleans presence
+    // immediately (sessions → `closed`) rather than leaving it to expire as
+    // false-live. We override the default signal terminate, so we MUST guarantee
+    // the process still exits — hence the unref'd fallback timer.
+    const ac = new AbortController();
+    const onSignal = (sig) => {
+        process.stderr.write(`h2a mcp-serve: received ${sig}, shutting down gracefully\n`);
+        ac.abort();
+        setTimeout(() => process.exit(process.exitCode ?? 0), 750).unref();
+    };
+    for (const sig of ["SIGTERM", "SIGINT", "SIGHUP"]) {
+        process.once(sig, () => onSignal(sig));
+    }
+    runAsync("mcp-serve", runMcpServe(parseFlagsFrom(1), {
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        signal: ac.signal
+    }));
+}
+else if (argv[0] === "remote" && argv[1] === "serve") {
+    runAsync("remote serve", runRemoteServe(parseFlagsFrom(2)));
+}
+else if (argv[0] === "remote" && argv[1] === "send") {
+    runAsync("remote send", runRemoteSend(parseFlagsFrom(2)));
+}
+else if (argv[0] === "remote" && argv[1] === "mirror-serve") {
+    runAsync("remote mirror-serve", runMirrorServe(parseFlagsFrom(2)));
+}
+else if (argv[0] === "remote" && argv[1] === "mirror") {
+    runAsync("remote mirror", runMirrorPush(parseFlagsFrom(2)));
+}
+else if (argv[0] === "drive" && argv[1] === "serve") {
+    runAsync("drive serve", runDriveServe(parseFlagsFrom(2)));
+}
+else if (argv[0] === "drumbeat" && argv[1] === "relance-inbox") {
+    runAsync("drumbeat relance-inbox", runDrumbeatRelanceInbox(parseFlagsFrom(2)));
+}
+else if (argv[0] === "drumbeat" && argv[1] === "watch") {
+    runAsync("drumbeat watch", runDrumbeatWatch(parseFlagsFrom(2)));
+}
+else if (argv[0] === "sysml" && argv[1] === "verify") {
+    runAsync("sysml verify", runSysmlVerify(parseFlagsFrom(2)));
+}
+else if (argv[0] === "keepalive") {
+    runAsync("keepalive", cmdKeepalive(parseFlagsFrom(1), { stdout: process.stdout, stderr: process.stderr }));
+}
+else {
+    process.exitCode = runCli(argv);
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/blockage.d.ts

@@ -9,7 +9,7 @@
  * Pure core: the type, an `isActiveBlockage` predicate, and a builder for a
  * signed-able envelope (parity with the NHI attestation, DEC-088) so a blockage
  * can be signed/journalled. The durable registry, notification and per-host
- * delivery live in `@sentropic/h2a-cli`.
+ * delivery live in `@sentropic/h2a`.
  */
 import type { H2AEnvelope, H2ARole } from "./types.js";
 export interface H2ABlockage {

package/dist/blockage.js

@@ -9,7 +9,7 @@
  * Pure core: the type, an `isActiveBlockage` predicate, and a builder for a
  * signed-able envelope (parity with the NHI attestation, DEC-088) so a blockage
  * can be signed/journalled. The durable registry, notification and per-host
- * delivery live in `@sentropic/h2a-cli`.
+ * delivery live in `@sentropic/h2a`.
  */
 import { computeHash } from "./canonical.js";
 import { createEnvelope } from "./envelope.js";

package/dist/cli-contract.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Stable JSON output contract + exit-code table for the `h2a` CLI surface.
+ *
+ * This module is the **machine-readable counterpart** of `docs/cli-contract.md`
+ * (DEC-034). Every verb exposed by `runCli` appears here with:
+ *
+ * - `outputShape`: one of three canonical envelopes (see below).
+ * - `exitCodes`: the subset of {0,1,2,3} the verb can return.
+ * - `requiredFlags` / `optionalFlags`: documented flag surface.
+ *
+ * Envelope shapes
+ * ---------------
+ *
+ * - `resource` — single entity persisted/loaded by the verb. Stdout is the
+ *   bare JSON of that entity (no `{ok}` wrapper). Examples: a negotiation
+ *   record, a journal entry, an envelope, the MCP config snippet for a host.
+ * - `list` — bare JSON array. Examples: `discover`, `inbox read`,
+ *   `negotiate journal`.
+ * - `action` — confirmation envelope `{ ok: true, ...details }` for verbs
+ *   that perform side effects but do not return a natural entity (`init`,
+ *   `register`, `inbox put`, `outbox put`, `negotiate stabilize`,
+ *   `host setup --write`).
+ * - `text` — non-JSON human output (currently only `--help`).
+ * - `stream` — long-running framed transport (`mcp-serve`, JSON-RPC 2.0
+ *   over stdio); no single stdout payload.
+ *
+ * Exit-code table
+ * ---------------
+ *
+ * - `0` success.
+ * - `1` user error — bad flag, missing required flag, invalid JSON,
+ *   validation failure on user input, unknown verb/subverb/host.
+ * - `2` runtime/state error — store conflict or business-rule failure
+ *   (negotiation not found, already open, already stabilized, signature
+ *   fails verification, quorum incomplete, broken journal, divergent
+ *   pre-existing config file).
+ * - `3` I/O / OS error — file unreadable, permission denied, write
+ *   refused by the filesystem.
+ *
+ * DEC-034 freezes this contract. Future breaking changes require a new DEC
+ * and a major version bump on `@sentropic/h2a`.
+ */
+export type H2ACliOutputShape = "resource" | "list" | "action" | "text" | "stream";
+export type H2ACliExitCode = 0 | 1 | 2 | 3;
+export interface H2ACliVerbContract {
+    /** Full verb path, space-separated (`"negotiate open"`, `"host setup"`). */
+    readonly verb: string;
+    /** Canonical envelope of the stdout payload on success. */
+    readonly outputShape: H2ACliOutputShape;
+    /** Exit codes this verb can produce. Always includes `0` for success. */
+    readonly exitCodes: readonly H2ACliExitCode[];
+    /** Flags required for a happy-path invocation. */
+    readonly requiredFlags: readonly string[];
+    /** Flags accepted but optional. */
+    readonly optionalFlags: readonly string[];
+    /** One-line human description. */
+    readonly description: string;
+}
+export declare const H2A_CLI_VERB_CONTRACTS: readonly H2ACliVerbContract[];
+/** Map of verb-path → contract for O(1) lookups in tests and tooling. */
+export declare const H2A_CLI_VERB_CONTRACT_BY_VERB: ReadonlyMap<string, H2ACliVerbContract>;
+//# sourceMappingURL=cli-contract.d.ts.map

package/dist/cli-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract.d.ts","sourceRoot":"","sources":["../src/cli-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnF,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EA4zBtD,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAEjF,CAAC"}