@hsuite/smart-engines-cli 1.0.1 → 1.1.0

package/README.md

@@ -84,7 +84,7 @@ Flow:
 1. Reads `XRPL_*` + `APP_NAME` from `.env.local`
 2. Builds a signer using `ripple-keypairs.sign`
 3. Authenticates via `BaasClient.authenticate({chain: 'xrpl', ...})` against the cluster
-4. Calls `BaasClient.register({name, services})` — cluster returns a real `appId`
+4. Calls `BaasClient.deployment.init({name, port, services})` — the new four-step deploy flow's step 1 (legacy `register()` removed in PR-A); the cluster runs the per-entity DKG ceremony and returns the DKG entityId as `appId`
 5. Appends `SUBSCRIPTION_APP_ID=<appId>` and `APP_ID=<appId>` to your `.env.local`, flips `SKIP_SUBSCRIPTION_CHECK=false`
 
 After this, your smart-app boots in cluster-mode automatically.
@@ -93,27 +93,43 @@ After this, your smart-app boots in cluster-mode automatically.
 
 ## `hsuite deploy`
 
-Deploy a smart-app from a JSON manifest via the SDK's
-`BaasClient.deployment.create()` endpoint. Use this when you want to
-publish a separate smart-app deployment artifact (e.g., as part of a CI
-pipeline).
+Deploy a smart-app image from a JSON manifest via the SDK's four-step
+runtime-orchestration flow (`init` → `docker push` → optional
+`uploadFrontend` → `deploy`). Use this for CI pipelines that ship a
+container image to the cluster.
 
 ```bash
 hsuite deploy --manifest ./my-app.json --env .env.local
+hsuite deploy --manifest ./my-app.json --env .env.local --non-interactive   # for CI
 ```
 
 `my-app.json`:
 
 ```json
 {
-  "name": "My Smart App",
+  "name": "my-smart-app",
+  "port": 3000,
+  "tag": "v1",
+  "replicas": 1,
   "services": ["database", "storage", "messaging", "functions"],
-  "config": {
-    "anything": "your smart-app needs at deploy time"
-  }
+  "env": { "NODE_ENV": "production" },
+  "frontend": { "bundlePath": "./dist/bundle.tar.gz" }
 }
 ```
 
+What the command does, in order:
+
+1. **`deployment.init`** — cluster allocates the `appId` (per-entity DKG
+   entityId) and returns ephemeral DOCR push credentials.
+2. **(out-of-band)** the CLI prints the `docker login` + `docker push`
+   commands and waits for Enter (skipped with `--non-interactive`,
+   `CI=true`, or no TTY — the caller is assumed to have completed the
+   push).
+3. **`deployment.uploadFrontend`** — if `frontend.bundlePath` is set, the
+   tarball is uploaded.
+4. **`deployment.deploy`** — the cluster reconciles the requested `tag`
+   + `replicas` + `env` to k8s.
+
 The returned `appId` is appended to `.env.local` as `DEPLOYED_APP_ID`.
 
 ---

package/dist/commands/deploy.d.ts

@@ -1,5 +1,18 @@
 /**
  * `hsuite deploy` — Deploy a smart-app from a JSON manifest.
+ *
+ * Implements the four-step runtime-deploy flow defined in
+ * `docs/superpowers/specs/2026-05-14-smart-app-runtime-orchestration-design.md` §6.1:
+ *
+ *   1. `init`                    → server allocates appId + ephemeral DOCR creds
+ *   2. (out-of-band, manual)     → customer `docker push <repo>:<tag>`
+ *   3. `uploadFrontend` (opt.)   → tarball with the SPA bundle
+ *   4. `deploy`                  → server reconciles to k8s
+ *
+ * The manifest schema widens to include `image`, `port`, `tag`, `replicas`,
+ * `env`, and an optional `frontend.bundlePath`. Between init and deploy the
+ * CLI prints the docker push command and waits for Enter (skipped in CI /
+ * with `--non-interactive`).
  */
 import { Command } from 'commander';
 export declare const deployCommand: Command;

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,eAAO,MAAM,aAAa,SAkEtB,CAAC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,eAAO,MAAM,aAAa,SA6HtB,CAAC"}

package/dist/commands/deploy.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,19 +39,57 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.deployCommand = void 0;
 /**
  * `hsuite deploy` — Deploy a smart-app from a JSON manifest.
+ *
+ * Implements the four-step runtime-deploy flow defined in
+ * `docs/superpowers/specs/2026-05-14-smart-app-runtime-orchestration-design.md` §6.1:
+ *
+ *   1. `init`                    → server allocates appId + ephemeral DOCR creds
+ *   2. (out-of-band, manual)     → customer `docker push <repo>:<tag>`
+ *   3. `uploadFrontend` (opt.)   → tarball with the SPA bundle
+ *   4. `deploy`                  → server reconciles to k8s
+ *
+ * The manifest schema widens to include `image`, `port`, `tag`, `replicas`,
+ * `env`, and an optional `frontend.bundlePath`. Between init and deploy the
+ * CLI prints the docker push command and waits for Enter (skipped in CI /
+ * with `--non-interactive`).
  */
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
 const fs_1 = require("fs");
 const path_1 = require("path");
+const readline = __importStar(require("readline"));
 const smart_engines_sdk_1 = require("@hsuite/smart-engines-sdk");
 const env_1 = require("../_lib/env");
+/**
+ * Block until the user presses Enter on stdin. Skipped in non-interactive
+ * mode (env `CI=true`, no TTY, or `--non-interactive` flag) — caller is
+ * assumed to have completed the docker push before invoking the CLI.
+ */
+async function waitForEnter() {
+    return new Promise((res) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('', () => {
+            rl.close();
+            res();
+        });
+    });
+}
+function isNonInteractive(flag) {
+    if (flag)
+        return true;
+    if (process.env.CI === 'true')
+        return true;
+    if (!process.stdin.isTTY)
+        return true;
+    return false;
+}
 exports.deployCommand = new commander_1.Command('deploy')
-    .description('Deploy a smart-app from a JSON manifest')
+    .description('Deploy a smart-app from a JSON manifest (init → push → deploy)')
     .requiredOption('--manifest <file>', 'JSON manifest path')
     .option('--env <file>', 'Env file with auth creds', '.env.local')
     .option('--gateway <url>', 'Smart-engines gateway URL', 'https://v3-testnet-gateway.hsuite.network')
+    .option('--non-interactive', 'Skip the wait-for-Enter between init and deploy', false)
     .action(async (opts) => {
     console.log(chalk_1.default.bold.cyan('\n  hsuite deploy\n'));
     const manifestPath = (0, path_1.resolve)(opts.manifest);
@@ -27,13 +98,18 @@ exports.deployCommand = new commander_1.Command('deploy')
         process.exit(1);
     }
     const manifest = JSON.parse((0, fs_1.readFileSync)(manifestPath, 'utf8'));
-    if (!manifest.name || !Array.isArray(manifest.services)) {
-        console.error(chalk_1.default.red(`  manifest must have at minimum {name, services[]}\n`));
+    if (!manifest.name ||
+        typeof manifest.port !== 'number' ||
+        !Array.isArray(manifest.services) ||
+        !manifest.tag) {
+        console.error(chalk_1.default.red(`  manifest must have at minimum {name, port, services[], tag}\n`));
         process.exit(1);
     }
     console.log(chalk_1.default.gray(`  manifest: ${manifestPath}`));
     console.log(chalk_1.default.gray(`  name:     ${manifest.name}`));
-    console.log(chalk_1.default.gray(`  services: ${manifest.services.join(', ')}`));
+    console.log(chalk_1.default.gray(`  port:     ${manifest.port}`));
+    console.log(chalk_1.default.gray(`  services: ${manifest.services.join(', ') || '(none)'}`));
+    console.log(chalk_1.default.gray(`  tag:      ${manifest.tag}`));
     console.log(chalk_1.default.gray(`  gateway:  ${opts.gateway}\n`));
     const env = (0, env_1.readEnv)(opts.env);
     const signer = (0, env_1.buildSignerFromEnv)(env);
@@ -57,21 +133,67 @@ exports.deployCommand = new commander_1.Command('deploy')
         process.exit(1);
     }
     spinner.succeed('authenticated');
-    spinner = (0, ora_1.default)('deploy...').start();
-    let result;
+    // ── Step 1: init ──────────────────────────────────────────────────
+    spinner = (0, ora_1.default)('init...').start();
+    let init;
     try {
-        result = await client.deployment.create({
+        init = await client.deployment.init({
             name: manifest.name,
+            port: manifest.port,
             services: manifest.services,
-            config: manifest.config,
+            limits: manifest.limits,
+        });
+    }
+    catch (err) {
+        spinner.fail(`init failed: ${err.message}`);
+        process.exit(1);
+    }
+    spinner.succeed(`init: appId=${init.appId} registry=${init.registry.repository}`);
+    // ── Step 2 (out-of-band): docker push ─────────────────────────────
+    console.log(chalk_1.default.bold.yellow('\n  → push your image now:'));
+    console.log(`    echo ${JSON.stringify(init.registry.password)} | docker login ${init.registry.server} -u ${init.registry.username} --password-stdin`);
+    console.log(`    docker push ${init.registry.server}/${init.registry.repository}:${manifest.tag}`);
+    if (!isNonInteractive(opts.nonInteractive)) {
+        console.log(chalk_1.default.bold.yellow('\n  → press Enter when push is complete'));
+        await waitForEnter();
+    }
+    else {
+        console.log(chalk_1.default.gray('  (non-interactive: assuming push already complete)'));
+    }
+    // ── Step 3 (optional): upload frontend ────────────────────────────
+    if (manifest.frontend?.bundlePath) {
+        const bundlePath = (0, path_1.resolve)(manifest.frontend.bundlePath);
+        if (!(0, fs_1.existsSync)(bundlePath)) {
+            console.error(chalk_1.default.red(`  frontend bundle not found: ${bundlePath}\n`));
+            process.exit(1);
+        }
+        spinner = (0, ora_1.default)('uploading frontend bundle...').start();
+        try {
+            const bundle = await fs_1.promises.readFile(bundlePath);
+            const upload = await client.deployment.uploadFrontend(init.appId, bundle);
+            spinner.succeed(`frontend uploaded: sha256=${upload.bundleSha256.slice(0, 12)}…`);
+        }
+        catch (err) {
+            spinner.fail(`frontend upload failed: ${err.message}`);
+            process.exit(1);
+        }
+    }
+    // ── Step 4: deploy ────────────────────────────────────────────────
+    spinner = (0, ora_1.default)('deploying...').start();
+    let deployRes;
+    try {
+        deployRes = await client.deployment.deploy(init.appId, {
+            tag: manifest.tag,
+            replicas: manifest.replicas ?? 1,
+            env: manifest.env,
         });
     }
     catch (err) {
         spinner.fail(`deploy failed: ${err.message}`);
         process.exit(1);
     }
-    spinner.succeed(`deployed: appId=${result.appId} status=${result.status}`);
-    (0, env_1.upsertEnv)(opts.env, { DEPLOYED_APP_ID: result.appId });
+    spinner.succeed(`deployed: ${deployRes.url}`);
+    (0, env_1.upsertEnv)(opts.env, { DEPLOYED_APP_ID: init.appId });
     console.log(chalk_1.default.bold.green('\n  ✓ done\n'));
 });
 //# sourceMappingURL=deploy.js.map

package/dist/commands/deploy.js.map

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

package/dist/commands/governance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `hsuite governance simulate` — dry-run a `GovernanceMolecule.validate(...)`
+ * against fixture data without depending on the rules-engine package.
+ *
+ * Usage:
+ *   hsuite governance simulate --proposal <file> [--server <url>] [--format json|plain]
+ *
+ * The `<file>` is a JSON document of shape `{ config, context }` matching the
+ * SDK's `GovernanceSimulateRequest` type.
+ *
+ * Exit codes:
+ *   0 — `result.isValid === true`
+ *   1 — `result.isValid === false` (proposal/vote/etc. rejected by the molecule)
+ *   2 — input or transport error (missing file, malformed JSON, HTTP failure)
+ */
+import { Command } from 'commander';
+import { SmartEngineClient } from '@hsuite/smart-engines-sdk';
+/**
+ * Internal SDK builder — exposed for tests to inject a stub.
+ *
+ * Each call returns a `SmartEngineClient` configured for the given server.
+ */
+export declare function buildSdkClient(server: string): SmartEngineClient;
+/**
+ * Pure logic separated from `commander` for testability.
+ *
+ * Returns the exit code rather than calling `process.exit`. The action
+ * handler wraps this and exits.
+ */
+export declare function runGovernanceSimulate(opts: {
+    proposal: string;
+    server?: string;
+    format?: 'json' | 'plain';
+    /** Test seam — override the SDK constructor. */
+    clientFactory?: (server: string) => Pick<SmartEngineClient, 'governance'>;
+    /** Test seam — capture stdout instead of writing to process. */
+    out?: (line: string) => void;
+    /** Test seam — capture stderr instead of writing to process. */
+    err?: (line: string) => void;
+}): Promise<number>;
+export declare const governanceCommand: Command;
+//# sourceMappingURL=governance.d.ts.map

package/dist/commands/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/commands/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAiD9D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAKhE;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,gDAAgD;IAChD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAC1E,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ClB;AAED,eAAO,MAAM,iBAAiB,SAiB3B,CAAC"}

package/dist/commands/governance.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceCommand = void 0;
+exports.buildSdkClient = buildSdkClient;
+exports.runGovernanceSimulate = runGovernanceSimulate;
+/**
+ * `hsuite governance simulate` — dry-run a `GovernanceMolecule.validate(...)`
+ * against fixture data without depending on the rules-engine package.
+ *
+ * Usage:
+ *   hsuite governance simulate --proposal <file> [--server <url>] [--format json|plain]
+ *
+ * The `<file>` is a JSON document of shape `{ config, context }` matching the
+ * SDK's `GovernanceSimulateRequest` type.
+ *
+ * Exit codes:
+ *   0 — `result.isValid === true`
+ *   1 — `result.isValid === false` (proposal/vote/etc. rejected by the molecule)
+ *   2 — input or transport error (missing file, malformed JSON, HTTP failure)
+ */
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const smart_engines_sdk_1 = require("@hsuite/smart-engines-sdk");
+const DEFAULT_SERVER = 'https://v3-testnet-gateway.hsuite.network';
+/** Exit-code-bearing error so the action handler can branch precisely. */
+class CliExit extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+function readProposal(file) {
+    const path = (0, path_1.resolve)(file);
+    if (!(0, fs_1.existsSync)(path)) {
+        throw new CliExit(2, `proposal file not found: ${path}`);
+    }
+    let raw;
+    try {
+        raw = (0, fs_1.readFileSync)(path, 'utf8');
+    }
+    catch (err) {
+        throw new CliExit(2, `unable to read proposal file: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new CliExit(2, `malformed JSON in proposal file: ${err.message}`);
+    }
+    if (!parsed ||
+        typeof parsed !== 'object' ||
+        !('config' in parsed) ||
+        !('context' in parsed)) {
+        throw new CliExit(2, 'proposal file must be JSON with shape { "config": {...}, "context": {...} }');
+    }
+    return parsed;
+}
+/**
+ * Internal SDK builder — exposed for tests to inject a stub.
+ *
+ * Each call returns a `SmartEngineClient` configured for the given server.
+ */
+function buildSdkClient(server) {
+    return new smart_engines_sdk_1.SmartEngineClient({
+        baseUrl: server,
+        allowInsecure: server.startsWith('http://'),
+    });
+}
+/**
+ * Pure logic separated from `commander` for testability.
+ *
+ * Returns the exit code rather than calling `process.exit`. The action
+ * handler wraps this and exits.
+ */
+async function runGovernanceSimulate(opts) {
+    const write = opts.out ?? ((line) => console.log(line));
+    const writeErr = opts.err ?? ((line) => console.error(line));
+    const server = opts.server ?? DEFAULT_SERVER;
+    const format = opts.format ?? 'plain';
+    let request;
+    try {
+        request = readProposal(opts.proposal);
+    }
+    catch (err) {
+        if (err instanceof CliExit) {
+            writeErr(chalk_1.default.red(`  ${err.message}`));
+            return err.code;
+        }
+        writeErr(chalk_1.default.red(`  unexpected error: ${err.message}`));
+        return 2;
+    }
+    const client = (opts.clientFactory ?? buildSdkClient)(server);
+    let result;
+    try {
+        result = await client.governance.simulate(request);
+    }
+    catch (err) {
+        writeErr(chalk_1.default.red(`  simulate failed: ${err.message}`));
+        return 2;
+    }
+    if (format === 'json') {
+        write(JSON.stringify(result, null, 2));
+    }
+    else {
+        const status = result.isValid
+            ? chalk_1.default.bold.green('VALID')
+            : chalk_1.default.bold.red('INVALID');
+        write(`  ${status}`);
+        if (result.reason) {
+            write(chalk_1.default.gray(`  reason:    ${result.reason}`));
+        }
+        if (result.metadata && Object.keys(result.metadata).length > 0) {
+            write(chalk_1.default.gray(`  metadata:  ${JSON.stringify(result.metadata)}`));
+        }
+        if (result.validatedAt) {
+            write(chalk_1.default.gray(`  validated: ${result.validatedAt}`));
+        }
+    }
+    return result.isValid ? 0 : 1;
+}
+exports.governanceCommand = new commander_1.Command('governance')
+    .description('Governance proposal dry-run')
+    .addCommand(new commander_1.Command('simulate')
+    .description('Dry-run a GovernanceMolecule.validate(...) against a fixture file')
+    .requiredOption('--proposal <file>', 'JSON file with shape { config, context }')
+    .option('--server <url>', 'Validator base URL', DEFAULT_SERVER)
+    .option('--format <format>', 'Output format: json | plain', 'plain')
+    .action(async (opts) => {
+    const format = opts.format === 'json' ? 'json' : 'plain';
+    const code = await runGovernanceSimulate({
+        proposal: opts.proposal,
+        server: opts.server,
+        format,
+    });
+    process.exit(code);
+}));
+//# sourceMappingURL=governance.js.map

package/dist/commands/governance.js.map

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

package/dist/commands/hist-balance.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `hsuite hist-balance query` — ad-hoc historical-balance query.
+ *
+ * Wraps the SDK's `HistoricalBalanceClient` so operators / smart-app devs
+ * can sanity-check archive reads from a terminal without writing a script:
+ *
+ * ```
+ * hsuite hist-balance query \
+ *   --chain hedera \
+ *   --entity 0.0.5555 \
+ *   --account 0.0.1234 \
+ *   --at 1700000000 \
+ *   --server https://validator.example.com
+ * ```
+ *
+ * Exit codes:
+ *   0  success
+ *   1  input error (missing/invalid flag, unsupported chain, etc.)
+ *   2  transport or server error (network, 4xx, 5xx)
+ *
+ * Zero internal `@hsuite/*` deps beyond `@hsuite/smart-engines-sdk`, which
+ * itself is decoupled from server-side libs by design (PR-CLEANUP #576).
+ */
+import { Command } from 'commander';
+import { HistoricalBalanceClient } from '@hsuite/smart-engines-sdk';
+type RunArgs = {
+    chain?: string;
+    entity?: string;
+    account?: string;
+    at?: string;
+    server?: string;
+    format?: string;
+    authToken?: string;
+    apiKey?: string;
+};
+/**
+ * Pure-function core (no `process.exit`, no `console.log`) so tests can
+ * exercise the full code path and assert on the returned exit code +
+ * captured streams.
+ */
+export declare function runHistBalanceQuery(args: RunArgs, io: {
+    out: (msg: string) => void;
+    err: (msg: string) => void;
+    sdk?: (config: {
+        baseUrl: string;
+        authToken?: string;
+        apiKey?: string;
+    }) => Pick<HistoricalBalanceClient, 'getBalance'>;
+}): Promise<number>;
+export declare const histBalanceCommand: Command;
+export {};
+//# sourceMappingURL=hist-balance.d.ts.map

package/dist/commands/hist-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hist-balance.d.ts","sourceRoot":"","sources":["../../src/commands/hist-balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,uBAAuB,EAGxB,MAAM,2BAA2B,CAAC;AAEnC,KAAK,OAAO,GAAG;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,EACb,EAAE,EAAE;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;CACnD,GACA,OAAO,CAAC,MAAM,CAAC,CA6FjB;AAED,eAAO,MAAM,kBAAkB,SAE9B,CAAC"}

package/dist/commands/hist-balance.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * `hsuite hist-balance query` — ad-hoc historical-balance query.
+ *
+ * Wraps the SDK's `HistoricalBalanceClient` so operators / smart-app devs
+ * can sanity-check archive reads from a terminal without writing a script:
+ *
+ * ```
+ * hsuite hist-balance query \
+ *   --chain hedera \
+ *   --entity 0.0.5555 \
+ *   --account 0.0.1234 \
+ *   --at 1700000000 \
+ *   --server https://validator.example.com
+ * ```
+ *
+ * Exit codes:
+ *   0  success
+ *   1  input error (missing/invalid flag, unsupported chain, etc.)
+ *   2  transport or server error (network, 4xx, 5xx)
+ *
+ * Zero internal `@hsuite/*` deps beyond `@hsuite/smart-engines-sdk`, which
+ * itself is decoupled from server-side libs by design (PR-CLEANUP #576).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.histBalanceCommand = void 0;
+exports.runHistBalanceQuery = runHistBalanceQuery;
+const commander_1 = require("commander");
+const smart_engines_sdk_1 = require("@hsuite/smart-engines-sdk");
+/**
+ * Pure-function core (no `process.exit`, no `console.log`) so tests can
+ * exercise the full code path and assert on the returned exit code +
+ * captured streams.
+ */
+async function runHistBalanceQuery(args, io) {
+    // ── Input validation ──────────────────────────────────────────────────
+    const chain = args.chain;
+    if (chain !== 'hedera' && chain !== 'xrpl' && chain !== 'polkadot') {
+        io.err(`error: --chain must be one of hedera | xrpl | polkadot (received: ${chain ?? '<missing>'})`);
+        return 1;
+    }
+    const entity = args.entity;
+    if (!entity || typeof entity !== 'string') {
+        io.err('error: --entity is required');
+        return 1;
+    }
+    const account = args.account;
+    if (!account || typeof account !== 'string') {
+        io.err('error: --account is required');
+        return 1;
+    }
+    if (args.at === undefined || args.at === '') {
+        io.err('error: --at is required (unix seconds, positive integer)');
+        return 1;
+    }
+    const atNum = Number(args.at);
+    if (!Number.isInteger(atNum) || atNum <= 0) {
+        io.err(`error: --at must be a positive integer (received: ${args.at})`);
+        return 1;
+    }
+    const server = args.server ?? process.env.VALIDATOR_URL ?? process.env.SMART_HOST_URL;
+    if (!server) {
+        io.err('error: --server is required (or set VALIDATOR_URL / SMART_HOST_URL env)');
+        return 1;
+    }
+    const format = args.format ?? 'plain';
+    if (format !== 'plain' && format !== 'json') {
+        io.err(`error: --format must be plain | json (received: ${format})`);
+        return 1;
+    }
+    const authToken = args.authToken ?? process.env.VALIDATOR_AUTH_TOKEN;
+    const apiKey = args.apiKey ?? process.env.VALIDATOR_API_KEY;
+    // ── Build SDK client ──────────────────────────────────────────────────
+    const factory = io.sdk ??
+        ((cfg) => new smart_engines_sdk_1.HistoricalBalanceClient({
+            baseUrl: cfg.baseUrl,
+            authToken: cfg.authToken,
+            apiKey: cfg.apiKey,
+        }));
+    const client = factory({ baseUrl: server, authToken, apiKey });
+    // ── Call ──────────────────────────────────────────────────────────────
+    try {
+        const result = await client.getBalance({
+            chain: chain,
+            entityId: entity,
+            account,
+            atTimestamp: atNum,
+        });
+        if (format === 'json') {
+            io.out(JSON.stringify(result, null, 2));
+        }
+        else {
+            io.out(`chain:       ${result.chain}`);
+            io.out(`entity:      ${result.entityId}`);
+            io.out(`account:     ${result.account}`);
+            io.out(`atTimestamp: ${result.atTimestamp}`);
+            io.out(`balance:     ${result.balance}`);
+            io.out(`source:      ${result.source}`);
+        }
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof smart_engines_sdk_1.HistoricalBalanceClientError) {
+            // Client-side validation is also surfaced as HistoricalBalanceClientError
+            // with statusCode=400; treat 4xx as input errors, 5xx / 0 as transport.
+            const isInputError = err.statusCode >= 400 && err.statusCode < 500;
+            io.err(`error: ${err.message} (status=${err.statusCode})`);
+            return isInputError ? 1 : 2;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        io.err(`error: ${message}`);
+        return 2;
+    }
+}
+exports.histBalanceCommand = new commander_1.Command('hist-balance').description('Query historical balances against the validator archive endpoint');
+exports.histBalanceCommand
+    .command('query')
+    .description('Look up a point-in-time balance for an account / entity / chain')
+    .requiredOption('--chain <chain>', 'Chain: hedera | xrpl | polkadot')
+    .requiredOption('--entity <id>', 'Chain-native token / IOU / asset id')
+    .requiredOption('--account <addr>', 'Chain-native holder address')
+    .requiredOption('--at <unixSeconds>', 'Unix timestamp in seconds (positive integer)')
+    .option('--server <url>', 'Validator base URL (default: $VALIDATOR_URL or $SMART_HOST_URL)')
+    .option('--format <format>', 'Output format: plain | json', 'plain')
+    .option('--auth-token <token>', 'Bearer token (default: $VALIDATOR_AUTH_TOKEN)')
+    .option('--api-key <key>', 'API key (default: $VALIDATOR_API_KEY)')
+    .action(async (opts) => {
+    const code = await runHistBalanceQuery(opts, {
+        out: (m) => console.log(m),
+        err: (m) => console.error(m),
+    });
+    process.exit(code);
+});
+//# sourceMappingURL=hist-balance.js.map

package/dist/commands/hist-balance.js.map

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

package/dist/commands/personhood.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `hsuite personhood verify` — verify a personhood proof against the cluster.
+ *
+ * Thin wrapper around the SDK's `PersonhoodClient`. Reads a JSON proof from
+ * disk, POSTs to the validator, and prints the resulting cert (or `null`)
+ * to stdout or `--out`.
+ *
+ * Exit codes:
+ *   0  cert issued (printed to stdout / --out)
+ *   0  null cert  (info message printed to stderr, body printed to stdout)
+ *   1  input error: missing file, malformed JSON, missing --candidate
+ *   2  transport error: 5xx, network, timeout
+ *
+ * The 503 `personhood_verifier_not_configured` envelope is treated as a
+ * transport-level error (exit 2) because the hub operator must wire a
+ * verifier before this command can succeed.
+ */
+import { Command } from 'commander';
+import { PersonhoodClient } from '@hsuite/smart-engines-sdk';
+/**
+ * Internal factory hook — overridable in tests to mock the SDK client.
+ * Production callers never set this; the CLI builds a real
+ * `SmartEngineClient` against `--server`.
+ */
+export type PersonhoodClientFactory = (server: string) => PersonhoodClient;
+/** @internal — for tests only. */
+export declare function __setPersonhoodClientFactory(factory: PersonhoodClientFactory): void;
+/** @internal — for tests only. */
+export declare function __resetPersonhoodClientFactory(): void;
+/**
+ * Build a fresh `personhood` Command tree. Commander Command instances
+ * accumulate state across `parseAsync` calls (parsed option values stick
+ * around on the same node), so tests use this factory to get an
+ * isolated subtree per test. The bin entrypoint calls it once at startup.
+ */
+export declare function buildPersonhoodCommand(): Command;
+/**
+ * Default command instance used by the bin entrypoint. Tests build their
+ * own via {@link buildPersonhoodCommand}.
+ */
+export declare const personhoodCommand: Command;
+//# sourceMappingURL=personhood.d.ts.map

package/dist/commands/personhood.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personhood.d.ts","sourceRoot":"","sources":["../../src/commands/personhood.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EACL,gBAAgB,EAMjB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAQ3E,kCAAkC;AAClC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAEnF;AAED,kCAAkC;AAClC,wBAAgB,8BAA8B,IAAI,IAAI,CAMrD;AA0BD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA4EhD;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SAA2B,CAAC"}

package/dist/commands/personhood.js

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.personhoodCommand = void 0;
+exports.__setPersonhoodClientFactory = __setPersonhoodClientFactory;
+exports.__resetPersonhoodClientFactory = __resetPersonhoodClientFactory;
+exports.buildPersonhoodCommand = buildPersonhoodCommand;
+/**
+ * `hsuite personhood verify` — verify a personhood proof against the cluster.
+ *
+ * Thin wrapper around the SDK's `PersonhoodClient`. Reads a JSON proof from
+ * disk, POSTs to the validator, and prints the resulting cert (or `null`)
+ * to stdout or `--out`.
+ *
+ * Exit codes:
+ *   0  cert issued (printed to stdout / --out)
+ *   0  null cert  (info message printed to stderr, body printed to stdout)
+ *   1  input error: missing file, malformed JSON, missing --candidate
+ *   2  transport error: 5xx, network, timeout
+ *
+ * The 503 `personhood_verifier_not_configured` envelope is treated as a
+ * transport-level error (exit 2) because the hub operator must wire a
+ * verifier before this command can succeed.
+ */
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const smart_engines_sdk_1 = require("@hsuite/smart-engines-sdk");
+let clientFactory = (server) => {
+    const allowInsecure = server.startsWith('http://');
+    const sdk = new smart_engines_sdk_1.SmartEngineClient({ baseUrl: server, allowInsecure });
+    return sdk.personhood;
+};
+/** @internal — for tests only. */
+function __setPersonhoodClientFactory(factory) {
+    clientFactory = factory;
+}
+/** @internal — for tests only. */
+function __resetPersonhoodClientFactory() {
+    clientFactory = (server) => {
+        const allowInsecure = server.startsWith('http://');
+        const sdk = new smart_engines_sdk_1.SmartEngineClient({ baseUrl: server, allowInsecure });
+        return sdk.personhood;
+    };
+}
+function loadProof(path) {
+    const absPath = (0, path_1.resolve)(path);
+    if (!(0, fs_1.existsSync)(absPath)) {
+        throw new Error(`proof file not found: ${absPath}`);
+    }
+    const raw = (0, fs_1.readFileSync)(absPath, 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`proof file is not valid JSON: ${err.message}`);
+    }
+    if (!parsed ||
+        typeof parsed !== 'object' ||
+        typeof parsed.attestationMethod !== 'string') {
+        throw new Error('proof file must be a JSON object with an `attestationMethod` string field');
+    }
+    return parsed;
+}
+/**
+ * Build a fresh `personhood` Command tree. Commander Command instances
+ * accumulate state across `parseAsync` calls (parsed option values stick
+ * around on the same node), so tests use this factory to get an
+ * isolated subtree per test. The bin entrypoint calls it once at startup.
+ */
+function buildPersonhoodCommand() {
+    const cmd = new commander_1.Command('personhood').description('Personhood verification (HPP one-human-one-member)');
+    cmd
+        .command('verify')
+        .description('Verify a personhood proof against the cluster')
+        .requiredOption('--candidate <addr>', 'address of the human being verified')
+        .requiredOption('--proof <file>', 'JSON file containing the PersonhoodProof envelope')
+        .option('--out <file>', 'Write cert JSON to this file (default: stdout)')
+        .option('--server <url>', 'Validator base URL (default: $VALIDATOR_URL env)')
+        .action(async (opts) => {
+        const server = opts.server ?? process.env.VALIDATOR_URL;
+        if (!server) {
+            console.error(chalk_1.default.red('  --server is required (or set VALIDATOR_URL in the environment)\n'));
+            process.exit(1);
+        }
+        let proof;
+        try {
+            proof = loadProof(opts.proof);
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`  ${err.message}\n`));
+            process.exit(1);
+        }
+        const spinner = (0, ora_1.default)(`POST ${server}/api/v3/personhood/verify`).start();
+        let cert;
+        try {
+            const client = clientFactory(server);
+            cert = await client.verify({ candidate: opts.candidate, proof });
+        }
+        catch (err) {
+            // 503 personhood_verifier_not_configured → operator must wire a
+            // verifier; surface as a transport-level failure.
+            if ((0, smart_engines_sdk_1.isPersonhoodVerifierNotConfigured)(err)) {
+                spinner.fail('personhood verifier is not configured on the cluster');
+                process.exit(2);
+            }
+            if (err instanceof smart_engines_sdk_1.SdkHttpError) {
+                spinner.fail(`HTTP ${err.statusCode}: ${err.message}`);
+                process.exit(2);
+            }
+            spinner.fail(`transport error: ${err.message}`);
+            process.exit(2);
+        }
+        if (cert === null) {
+            spinner.warn('verification did not produce a cert');
+            // The body is still emitted so scripts can pipe / diff a stable JSON
+            // shape regardless of the issued/rejected outcome.
+            const body = JSON.stringify(null);
+            if (opts.out) {
+                (0, fs_1.writeFileSync)((0, path_1.resolve)(opts.out), body);
+            }
+            else {
+                process.stdout.write(body + '\n');
+            }
+            // Exit 0: rejection is a valid outcome the caller can branch on.
+            return;
+        }
+        spinner.succeed(`cert issued by ${cert.issuerId}`);
+        const body = JSON.stringify(cert, null, 2);
+        if (opts.out) {
+            (0, fs_1.writeFileSync)((0, path_1.resolve)(opts.out), body);
+            console.log(chalk_1.default.gray(`  wrote cert → ${opts.out}`));
+        }
+        else {
+            process.stdout.write(body + '\n');
+        }
+    });
+    return cmd;
+}
+/**
+ * Default command instance used by the bin entrypoint. Tests build their
+ * own via {@link buildPersonhoodCommand}.
+ */
+exports.personhoodCommand = buildPersonhoodCommand();
+//# sourceMappingURL=personhood.js.map

package/dist/commands/personhood.js.map

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

package/dist/commands/subscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/commands/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,gBAAgB,SAsFzB,CAAC"}
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/commands/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,gBAAgB,SAqGzB,CAAC"}

package/dist/commands/subscribe.js

@@ -35,7 +35,15 @@ exports.subscribeCommand = new commander_1.Command('subscribe')
         console.error(chalk_1.default.gray('  hint: run `hsuite init` first\n'));
         process.exit(1);
     }
-    const appName = opts.name ?? env.get('APP_NAME') ?? 'Smart App Showcase';
+    // The init endpoint requires a DNS-safe name (lowercase alphanumeric +
+    // hyphens, max 63 chars). Normalise the display-name accordingly so a
+    // CLI invocation with a free-text APP_NAME doesn't 400 at the boundary.
+    const rawAppName = opts.name ?? env.get('APP_NAME') ?? 'smart-app-showcase';
+    const appName = rawAppName
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 63) || 'smart-app-showcase';
     const services = opts.services
         .split(',')
         .map((s) => s.trim())
@@ -73,15 +81,22 @@ exports.subscribeCommand = new commander_1.Command('subscribe')
     spinner = (0, ora_1.default)('register free_testnet smart-app...').start();
     let result;
     try {
-        result = await client.register({ name: appName, services });
+        // PR-A runtime-orchestration: `deployment.init` is the first step of
+        // the four-step deploy flow and the new entry-point for allocating an
+        // appId on the cluster. The legacy `BaasClient.register()` +
+        // `POST /api/deployment/apps` surface was removed (no backward compat
+        // per spec §4 hard rules). `subscribe` does not deploy an image, so
+        // we synthesise a reasonable default port — the runtime sub-doc is
+        // populated at `deploy` time (PR-D), not at init.
+        result = await client.deployment.init({ name: appName, port: 3000, services });
     }
     catch (err) {
         spinner.fail(`register failed: ${err.message}`);
         process.exit(1);
     }
     spinner.succeed(`appId: ${result.appId}`);
-    console.log(chalk_1.default.gray(`  status:   ${result.status}`));
-    console.log(chalk_1.default.gray(`  services: ${result.services.join(', ')}`));
+    console.log(chalk_1.default.gray(`  registry: ${result.registry.server}/${result.registry.repository}`));
+    console.log(chalk_1.default.gray(`  services: ${services.join(', ')}`));
     (0, env_1.upsertEnv)(opts.env, {
         SUBSCRIPTION_APP_ID: result.appId,
         APP_ID: result.appId,

package/dist/commands/subscribe.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/commands/subscribe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/commands/subscribe.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,yCAAoC;AACpC,kDAA0B;AAC1B,8CAAsB;AACtB,iEAAuD;AAGvD,qCAAqE;AAExD,QAAA,gBAAgB,GAAG,IAAI,mBAAO,CAAC,WAAW,CAAC;KACrD,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,cAAc,EAAE,iCAAiC,EAAE,YAAY,CAAC;KACvE,MAAM,CACL,iBAAiB,EACjB,2BAA2B,EAC3B,2CAA2C,CAC5C;KACA,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CACL,mBAAmB,EACnB,oCAAoC,EACpC,sCAAsC,CACvC;KACA,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAEzD,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,aAAO,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAM,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC;IAC5E,MAAM,OAAO,GAAG,UAAU;SACvB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,oBAAoB,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;SAC3B,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAkB,CAAC;IAEpC,IAAI,OAAO,GAAG,IAAA,aAAG,EAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;IAChD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,wBAAkB,EAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,iBAAiB,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,IAAI,8BAAU,CAAC;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,SAAS;QAChB,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;QACjD,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;IAEH,OAAO,GAAG,IAAA,aAAG,EAAC,iCAAiC,CAAC,CAAC,KAAK,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjC,OAAO,GAAG,IAAA,aAAG,EAAC,oCAAoC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC5D,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,qEAAqE;QACrE,sEAAsE;QACtE,6DAA6D;QAC7D,sEAAsE;QACtE,oEAAoE;QACpE,mEAAmE;QACnE,kDAAkD;QAClD,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,oBAAqB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/F,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D,IAAA,eAAS,EAAC,IAAI,CAAC,GAAG,EAAE;QAClB,mBAAmB,EAAE,MAAM,CAAC,KAAK;QACjC,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,uBAAuB,EAAE,OAAO;KACjC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,6CAA6C,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -54,6 +54,9 @@ const path = __importStar(require("path"));
 const init_1 = require("./commands/init");
 const subscribe_1 = require("./commands/subscribe");
 const deploy_1 = require("./commands/deploy");
+const governance_1 = require("./commands/governance");
+const hist_balance_1 = require("./commands/hist-balance");
+const personhood_1 = require("./commands/personhood");
 dotenv.config();
 function getVersion() {
     try {
@@ -73,6 +76,9 @@ program
 program.addCommand(init_1.initCommand);
 program.addCommand(subscribe_1.subscribeCommand);
 program.addCommand(deploy_1.deployCommand);
+program.addCommand(governance_1.governanceCommand);
+program.addCommand(hist_balance_1.histBalanceCommand);
+program.addCommand(personhood_1.personhoodCommand);
 program.parse(process.argv);
 if (!process.argv.slice(2).length) {
     program.outputHelp();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yCAAoC;AACpC,+CAAiC;AACjC,uCAAyB;AACzB,2CAA6B;AAC7B,0CAA8C;AAC9C,oDAAwD;AACxD,8CAAkD;AAElD,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,4BAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAElC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yCAAoC;AACpC,+CAAiC;AACjC,uCAAyB;AACzB,2CAA6B;AAC7B,0CAA8C;AAC9C,oDAAwD;AACxD,8CAAkD;AAClD,sDAA0D;AAC1D,0DAA6D;AAC7D,sDAA0D;AAE1D,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,4BAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,8BAAiB,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,iCAAkB,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,8BAAiB,CAAC,CAAC;AAEtC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hsuite/smart-engines-cli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "HSuite CLI for smart-app deployment and management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",