@hardkas/cli 0.3.0-alpha → 0.4.0-alpha

package/dist/bridge-local-runner-E3LICYYX.js

@@ -0,0 +1,174 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/bridge-local-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runBridgeLocalPlan(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { planBridgeEntry, resolveBridgeLocalContext } = await import("@hardkas/bridge-local");
+    const { MockKaspaRpcClient } = await import("@hardkas/kaspa-rpc");
+    const ctx = await resolveBridgeLocalContext({
+      config,
+      sessionName: options.session,
+      from: options.from,
+      toIgra: options.toIgra
+    });
+    const amountSompi = BigInt(Math.floor(parseFloat(options.amount) * 1e8));
+    const rpc = new MockKaspaRpcClient();
+    rpc.setUtxos(ctx.l1.address, [
+      {
+        outpoint: { transactionId: "mock-utxo", index: 0 },
+        address: ctx.l1.address,
+        amountSompi: 100000000000n,
+        // 1000 KAS
+        scriptPublicKey: "mock-script"
+      }
+    ]);
+    const utxos = await rpc.getUtxosByAddress(ctx.l1.address);
+    const plan = planBridgeEntry({
+      fromAddress: ctx.l1.address,
+      targetEvmAddress: ctx.l2.address,
+      amountSompi,
+      networkId: config.config.networkId || config.config.defaultNetwork || "simnet",
+      availableUtxos: utxos.map((u) => ({ ...u, scriptPublicKey: "", blockDaaScore: u.blockDaaScore ? BigInt(u.blockDaaScore) : void 0 }))
+    });
+    if (options.json) {
+      console.log(JSON.stringify({
+        schema: "hardkas.bridgeLocalSessionPlan.v1",
+        session: {
+          source: ctx.source,
+          name: ctx.sessionName || null
+        },
+        l1: {
+          wallet: ctx.l1.walletName,
+          address: ctx.l1.address
+        },
+        l2: {
+          account: ctx.l2.accountName || null,
+          address: ctx.l2.address
+        },
+        bridge: {
+          mode: ctx.bridgeMode,
+          amount: options.amount,
+          payload: plan.serializedPayload
+        },
+        plan
+      }, (k, v) => typeof v === "bigint" ? v.toString() : v, 2));
+      return;
+    }
+    printBridgeContext(ctx, options.amount, plan.serializedPayload);
+    console.log(pc.bold("Local Bridge Entry Plan"));
+    console.log(pc.dim("----------------------------------------"));
+    console.log(`Fee (est):       ${pc.yellow(Number(plan.estimatedFeeSompi) / 1e8)} KAS`);
+    console.log(`Mass:            ${plan.estimatedMass}`);
+    console.log(pc.dim("----------------------------------------\n"));
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runBridgeLocalSimulate(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { planBridgeEntry, simulatePrefixMining, resolveBridgeLocalContext } = await import("@hardkas/bridge-local");
+    const { MockKaspaRpcClient } = await import("@hardkas/kaspa-rpc");
+    const ctx = await resolveBridgeLocalContext({
+      config,
+      sessionName: options.session,
+      from: options.from,
+      toIgra: options.toIgra
+    });
+    const amountSompi = BigInt(Math.floor(parseFloat(options.amount) * 1e8));
+    const rpc = new MockKaspaRpcClient();
+    rpc.setUtxos(ctx.l1.address, [
+      {
+        outpoint: { transactionId: "mock-utxo", index: 0 },
+        address: ctx.l1.address,
+        amountSompi: 100000000000n,
+        // 1000 KAS
+        scriptPublicKey: "mock-script"
+      }
+    ]);
+    const utxos = await rpc.getUtxosByAddress(ctx.l1.address);
+    const plan = planBridgeEntry({
+      fromAddress: ctx.l1.address,
+      targetEvmAddress: ctx.l2.address,
+      amountSompi,
+      networkId: config.config.networkId || config.config.defaultNetwork || "simnet",
+      availableUtxos: utxos.map((u) => ({ ...u, scriptPublicKey: "", blockDaaScore: u.blockDaaScore ? BigInt(u.blockDaaScore) : void 0 }))
+    });
+    if (!options.json) {
+      printBridgeContext(ctx, options.amount, plan.serializedPayload);
+      console.log(pc.bold("Bridge Entry Simulation"));
+      console.log(`${pc.cyan("Step 1:")} Planning entry transaction... OK`);
+      console.log(`${pc.cyan("Step 2:")} Simulating prefix mining for prefix "${pc.white(options.prefix)}"...`);
+    }
+    const miningResult = simulatePrefixMining(plan.bridgePayload, options.prefix);
+    if (options.json) {
+      console.log(JSON.stringify({
+        schema: "hardkas.bridgeLocalSessionSimulation.v1",
+        status: "success",
+        session: {
+          source: ctx.source,
+          name: ctx.sessionName || null
+        },
+        l1: {
+          wallet: ctx.l1.walletName,
+          address: ctx.l1.address
+        },
+        l2: {
+          account: ctx.l2.accountName || null,
+          address: ctx.l2.address
+        },
+        miningResult,
+        plan
+      }, (k, v) => typeof v === "bigint" ? v.toString() : v, 2));
+      return;
+    }
+    console.log(`  ${pc.green("\u2713")} Target found at nonce: ${pc.white(miningResult.nonce)}`);
+    console.log(`  ${pc.green("\u2713")} Attempts: ${miningResult.attempts}`);
+    console.log(`  ${pc.green("\u2713")} Simulated Hash: ${pc.dim(miningResult.hash)}`);
+    console.log(`
+${pc.bold(pc.green("SUCCESS"))}: Local bridge entry simulated.`);
+    console.log(pc.yellow(pc.bold("\n\u26A0\uFE0F  SIMULATION DISCLAIMER:")));
+    console.log(`  - ${pc.white("NO actual bridge settlement")} occurred on L1.`);
+    console.log(`  - ${pc.white("NO L2 minting")} or state change occurred on Igra.`);
+    console.log(`  - ${pc.white("NO real bridge validation")} or relayer action was involved.`);
+    console.log(`  - This is a ${pc.bold("deterministic local proof")} for development workflows only.
+`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runBridgeLocalInspect(txid, options) {
+  try {
+    console.log(pc.bold(`
+Inspecting Local Bridge Transaction: ${txid}`));
+    console.log(pc.dim("Feature limited in alpha: no local tx store yet."));
+  } catch (e) {
+    handleError(e);
+  }
+}
+function printBridgeContext(ctx, amount, payload) {
+  console.log(pc.bold("\nSession"));
+  console.log(`  Source: ${pc.white(ctx.source)}`);
+  console.log(`  Name:   ${pc.white(ctx.sessionName || "none")}`);
+  console.log(pc.bold("\nKaspa L1"));
+  console.log(`  Wallet:  ${pc.white(ctx.l1.walletName)}`);
+  console.log(`  Address: ${pc.dim(ctx.l1.address)}`);
+  console.log(pc.bold("\nIgra L2"));
+  console.log(`  Account: ${pc.white(ctx.l2.accountName || "explicit")}`);
+  console.log(`  Address: ${pc.dim(ctx.l2.address)}`);
+  console.log(pc.bold("\nBridge"));
+  console.log(`  Mode:    ${pc.white(ctx.bridgeMode)}`);
+  console.log(`  Amount:  ${pc.green(amount)} KAS`);
+  console.log(`  Payload: ${pc.dim(payload)}`);
+  console.log("");
+}
+export {
+  runBridgeLocalInspect,
+  runBridgeLocalPlan,
+  runBridgeLocalSimulate
+};

package/dist/dev-doctor-runner-LTSENPQ3.js

@@ -0,0 +1,145 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/dev-doctor-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runDevDoctor(options) {
+  const checks = [];
+  let finalStatus = "ready";
+  const timeoutMs = options.timeout ? parseInt(options.timeout, 10) : 3e3;
+  try {
+    const config = await loadHardkasConfig();
+    const networkId = config.config.networkId || config.config.defaultNetwork || "simnet";
+    const { getL2NetworkProfile, EvmJsonRpcClient, generateAddEthereumChainPayload } = await import("@hardkas/l2");
+    const { listHardkasAccounts } = await import("@hardkas/accounts");
+    let profile;
+    try {
+      profile = await getL2NetworkProfile({
+        name: options.profile,
+        userProfiles: config.config.l2?.networks,
+        cliOverrides: {
+          rpcUrl: options.rpcUrl || (networkId === "simnet" || networkId === "localnet" ? "http://127.0.0.1:8545" : void 0),
+          chainId: networkId === "simnet" || networkId === "localnet" ? 19416 : void 0
+        }
+      });
+    } catch (e) {
+      checks.push({ name: "L2 Profile", status: "error", message: e.message });
+      finalStatus = "failed";
+    }
+    if (profile) {
+      const rpcUrl = options.rpcUrl || profile.rpcUrl;
+      if (rpcUrl) {
+        const client = new EvmJsonRpcClient({ url: rpcUrl, timeoutMs });
+        try {
+          const block = await client.getBlockNumber();
+          checks.push({ name: "Igra RPC Connectivity", status: "success", message: `Reachable (Block #${block})` });
+        } catch (e) {
+          checks.push({ name: "Igra RPC Connectivity", status: "error", message: `Unreachable: ${e.message}` });
+          finalStatus = "failed";
+        }
+        if (profile.chainId !== void 0) {
+          try {
+            const chainId = await client.getChainId();
+            if (chainId === profile.chainId) {
+              checks.push({ name: "Chain ID Verification", status: "success", message: `Matches profile (${chainId})` });
+            } else {
+              checks.push({ name: "Chain ID Verification", status: "error", message: `Mismatch: profile expects ${profile.chainId}, node reports ${chainId}` });
+              finalStatus = "failed";
+            }
+          } catch (e) {
+          }
+        }
+        try {
+          const gasPrice = await client.getGasPriceWei();
+          checks.push({ name: "Gas Price Check", status: "success", message: `Responds (${gasPrice.toString()} wei)` });
+        } catch (e) {
+        }
+        const accounts = listHardkasAccounts(config.config);
+        const evmAccounts = accounts.filter((a) => a.kind === "evm-private-key");
+        let targetAccount = options.account ? evmAccounts.find((a) => a.name === options.account) : evmAccounts[0];
+        if (targetAccount) {
+          checks.push({ name: "Local EVM Account", status: "success", message: `Found "${targetAccount.name}" (${targetAccount.address})` });
+          if (targetAccount.address) {
+            try {
+              const balance = await client.getBalanceWei(targetAccount.address);
+              const kasBalance = Number(balance) / 1e18;
+              if (kasBalance > 0) {
+                checks.push({ name: "Account Balance", status: "success", message: `${kasBalance} iKAS` });
+              } else {
+                checks.push({ name: "Account Balance", status: "warning", message: "Zero balance (funding required)" });
+                if (finalStatus === "ready") finalStatus = "warning";
+              }
+            } catch (e) {
+            }
+          }
+        } else {
+          checks.push({ name: "Local EVM Account", status: "warning", message: "No EVM accounts found in config/store" });
+          if (finalStatus === "ready") finalStatus = "warning";
+        }
+        try {
+          generateAddEthereumChainPayload(profile);
+          checks.push({ name: "MetaMask Readiness", status: "success", message: "Payload generation OK" });
+        } catch (e) {
+          checks.push({ name: "MetaMask Readiness", status: "error", message: e.message });
+          finalStatus = "failed";
+        }
+      } else {
+        checks.push({ name: "RPC Configuration", status: "error", message: "No RPC URL found in profile or options" });
+        finalStatus = "failed";
+      }
+    }
+    if (finalStatus === "failed") {
+      process.exitCode = 1;
+    }
+    if (options.json) {
+      const result = {
+        schema: "hardkas.devDoctor.v1",
+        status: finalStatus,
+        checks
+      };
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 Dev Doctor`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    for (const check of checks) {
+      const icon = check.status === "success" ? pc.green("\u2713") : check.status === "warning" ? pc.yellow("\u26A0") : pc.red("\u2717");
+      console.log(`${icon} ${pc.bold(check.name)}: ${check.message}`);
+    }
+    console.log(pc.bold("\nStatus: ") + (finalStatus === "ready" ? pc.green("READY") : finalStatus === "warning" ? pc.yellow("WARNING") : pc.red("FAILED")));
+    if (finalStatus === "ready") {
+      const accName = options.account || "alice_evm";
+      console.log(`
+${pc.cyan("Next steps:")}`);
+      console.log(`  hardkas metamask account ${pc.white(accName)} --show-private-key
+`);
+    } else if (finalStatus === "failed") {
+      console.log(`
+${pc.red("Fix recommendations:")}`);
+      if (checks.some((c) => c.name === "Igra RPC Connectivity" && c.status === "error")) {
+        console.log(`  - Ensure your local Igra/EVM node is running on ${pc.white("http://127.0.0.1:8545")}`);
+        console.log(`  - Or use ${pc.cyan("--rpc-url <url>")} to specify a different node.`);
+      }
+      if (checks.some((c) => c.name === "Chain ID Verification" && c.status === "error")) {
+        console.log(`  - Your profile expect ${pc.white(profile?.chainId)}, but the node is on another network.`);
+      }
+      console.log("");
+    } else if (finalStatus === "warning") {
+      console.log(`
+${pc.yellow("Recommendations:")}`);
+      if (checks.some((c) => c.name === "Account Balance" && c.status === "warning")) {
+        console.log(`  - Fund your account: ${pc.white("hardkas wallet fund <name> --l2")}`);
+      }
+      console.log("");
+    }
+  } catch (e) {
+    process.exitCode = 1;
+    handleError(e);
+  }
+}
+export {
+  runDevDoctor
+};

package/dist/dev-server-runner-IM5DCDD3.js

@@ -0,0 +1,45 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/dev-server-runner.ts
+import pc from "picocolors";
+async function runDevServer(options) {
+  try {
+    const { createDevServer } = await import("@hardkas/dev-server");
+    const port = parseInt(options.port, 10);
+    let host = options.host;
+    if (options.unsafeExternal && options.host === "localhost") {
+      host = "0.0.0.0";
+    }
+    if (options.json) {
+      console.log(JSON.stringify({
+        schema: "hardkas.devServer.v1",
+        status: "running",
+        url: `http://${host}:${port}`,
+        config: { port, host, unsafeExternal: options.unsafeExternal }
+      }, null, 2));
+    }
+    const server = createDevServer({
+      port,
+      host,
+      unsafeExternal: options.unsafeExternal,
+      open: options.open
+    });
+    console.log(pc.bold("\nHardKas Dev Server"));
+    console.log(pc.dim("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    server.start();
+    console.log(pc.dim("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.yellow("LOCAL DEV ONLY"));
+    console.log(pc.dim("Press Ctrl+C to stop.\n"));
+    process.on("SIGINT", () => {
+      console.log("\nStopping Dev Server...");
+      process.exit(0);
+    });
+  } catch (e) {
+    handleError(e);
+  }
+}
+export {
+  runDevServer
+};

package/dist/index.js

@@ -266,8 +266,8 @@ async function runTxPlan(input) {
     const { target, name } = resolveNetworkTarget({ config, network: networkId });
     resolvedNetwork = name;
     if (target.kind === "simulated") {
-      const { loadOrCreateLocalnetState: loadOrCreateLocalnetState4, getSpendableUtxos } = await import("@hardkas/localnet");
-      const localState = await loadOrCreateLocalnetState4();
+      const { loadOrCreateLocalnetState: loadOrCreateLocalnetState3, getSpendableUtxos } = await import("@hardkas/localnet");
+      const localState = await loadOrCreateLocalnetState3();
       const unspent = getSpendableUtxos(localState, fromAddress);
       availableUtxos = unspent.map((u) => ({
         outpoint: {
@@ -879,8 +879,8 @@ Signed artifact saved to: ${options.out}`);
     await runTxVerify({ path: path15, ...options });
   });
   tx.command("trace <txId>").description(`Reconstruct the full operational trace of a transaction ${UI.maturity("research")}`).action(async (txId) => {
-    const { UI: UI2 } = await import("./ui-SUYOHGGP.js");
-    UI2.error("Tracing is temporarily disabled while the query API stabilizes.");
+    const { UI: UI3 } = await import("./ui-SUYOHGGP.js");
+    UI3.error("Tracing is temporarily disabled while the query API stabilizes.");
     process.exitCode = 1;
   });
 }
@@ -3049,9 +3049,6 @@ function registerConfigCommands(program) {
   });
 }
 
-// src/commands/misc.ts
-import { loadOrCreateLocalnetState as loadOrCreateLocalnetState3 } from "@hardkas/localnet";
-
 // src/runners/example-list-runner.ts
 import fs7 from "fs/promises";
 import path9 from "path";
@@ -3155,16 +3152,6 @@ function registerMiscCommands(program) {
       process.exitCode = 1;
     }
   });
-  program.command("dev").description("Start development environment").option("--mode <mode>", "simulated or node", "simulated").action(async (options) => {
-    if (options.mode === "simulated") {
-      const state = await loadOrCreateLocalnetState3();
-      UI.success("Local HardKAS devnet (simulated) is ready.");
-      UI.info(`Network: ${state.networkId}`);
-      UI.info(`Accounts: ${state.accounts.length}`);
-    } else {
-      UI.info("Node mode requires 'hardkas node start'.");
-    }
-  });
 }
 
 // src/commands/query.ts
@@ -5047,7 +5034,7 @@ function registerLocalnetCommands(program) {
 function registerDeployCommands(program) {
   const deployCmd = program.command("deploy").description("Track and manage deployments");
   deployCmd.command("track <label>").description(`Create a deployment record for a transaction ${UI.maturity("stable")}`).requiredOption("--network <name>", "Network where deployed").option("--tx-id <txId>", "Transaction ID").option("--plan <artifactId>", "Reference to plan artifact").option("--receipt <artifactId>", "Reference to receipt artifact").option("--status <status>", "Deployment status", "sent").option("--notes <text>", "Notes about this deployment").option("--json", "Output as JSON", false).action(async (label, opts) => {
-    const { UI: UI2 } = await import("./ui-SUYOHGGP.js");
+    const { UI: UI3 } = await import("./ui-SUYOHGGP.js");
     await trackDeployment({ label, ...opts });
   });
   deployCmd.command("list").description(`List all tracked deployments ${UI.maturity("stable")}`).option("--network <name>", "Filter by network").option("--status <status>", "Filter by status").option("--json", "Output as JSON", false).action(async (opts) => {
@@ -5064,13 +5051,160 @@ function registerDeployCommands(program) {
   });
 }
 
+// src/commands/metamask.ts
+function registerMetamaskCommands(program) {
+  const metamaskCmd = program.command("metamask").description("MetaMask onboarding and account export (local-dev only)");
+  metamaskCmd.command("network").description(`Show local Igra network parameters for MetaMask ${UI.maturity("stable")}`).option("--profile <name>", "L2 network profile name", "igra").option("--json", "Output as JSON", false).action(async (options) => {
+    const { runMetamaskNetwork } = await import("./metamask-runner-PRIOW4J3.js");
+    await runMetamaskNetwork(options);
+  });
+  metamaskCmd.command("snippet").description(`Generate JS snippet to add local network to MetaMask ${UI.maturity("stable")}`).option("--profile <name>", "L2 network profile name", "igra").action(async (options) => {
+    const { runMetamaskSnippet } = await import("./metamask-runner-PRIOW4J3.js");
+    await runMetamaskSnippet(options);
+  });
+  metamaskCmd.command("account <name>").description(`Export a local EVM account for MetaMask import ${UI.maturity("stable")}`).option("--show-private-key", "Reveal the private key (LOCAL DEV ONLY)", false).option("--json", "Output as JSON", false).option("--include-secret", "Include secret in JSON output (UNSAFE)", false).action(async (name, options) => {
+    const { runMetamaskAccount } = await import("./metamask-runner-PRIOW4J3.js");
+    await runMetamaskAccount(name, options);
+  });
+}
+
+// src/commands/dev.ts
+function registerDevCommands(program) {
+  const devCmd = program.command("dev").description("Local development and Igra-native environment tools");
+  devCmd.command("doctor").description(`Validate local dev environment readiness ${UI.maturity("stable")}`).option("--profile <name>", "L2 network profile name", "igra").option("--rpc-url <url>", "Explicit Igra RPC URL to check").option("--account <name>", "Local EVM account name to verify balance").option("--timeout <ms>", "RPC timeout in milliseconds", "3000").option("--json", "Output as JSON", false).action(async (options) => {
+    const { runDevDoctor } = await import("./dev-doctor-runner-LTSENPQ3.js");
+    await runDevDoctor(options);
+  });
+  devCmd.command("server").description(`Start the local HardKas Dev Server ${UI.maturity("stable")}`).option("--port <number>", "Port to bind to", "7420").option("--host <string>", "Host to bind to", "localhost").option("--open", "Open dashboard in browser automatically", false).option("--unsafe-external", "Allow external access (binds to 0.0.0.0 if host not specified)", false).option("--json", "Output status as JSON", false).action(async (options) => {
+    const { runDevServer } = await import("./dev-server-runner-IM5DCDD3.js");
+    await runDevServer(options);
+  });
+}
+
+// src/commands/local.ts
+function registerLocalCommands(program) {
+  const localCmd = program.command("local").description("Local development and environment lifecycle tools");
+  localCmd.command("wizard").description(`Guided setup for local development ${UI.maturity("stable")}`).option("--profile <name>", "L2 network profile name", "igra").option("--account <name>", "New or existing EVM account name", "dev_alice").option("--non-interactive", "Skip interactive prompts (will fail if input required)", false).option("--json", "Output as JSON", false).action(async (options) => {
+    const { runLocalWizard } = await import("./local-wizard-runner-GCAWGZ6D.js");
+    await runLocalWizard(options);
+  });
+}
+
+// src/commands/kaspa.ts
+function registerKaspaCommands(program) {
+  const kaspaCmd = program.command("kaspa").description("Kaspa L1 native developer tools");
+  const walletCmd = kaspaCmd.command("wallet").description("Manage local Kaspa L1 wallets");
+  walletCmd.command("create <name>").description(`Create a new local Kaspa wallet ${UI.maturity("stable")}`).option("--network <id>", "Kaspa network ID", "simnet").action(async (name, options) => {
+    const { runKaspaWalletCreate } = await import("./kaspa-wallet-runner-ORJ5YFKU.js");
+    await runKaspaWalletCreate(name, options);
+  });
+  walletCmd.command("list").description(`List local Kaspa wallets ${UI.maturity("stable")}`).option("--json", "Output as JSON", false).action(async (options) => {
+    const { runKaspaWalletList } = await import("./kaspa-wallet-runner-ORJ5YFKU.js");
+    await runKaspaWalletList(options);
+  });
+  walletCmd.command("address <name>").description(`Show address of a local Kaspa wallet ${UI.maturity("stable")}`).action(async (name) => {
+    const { runKaspaWalletAddress } = await import("./kaspa-wallet-runner-ORJ5YFKU.js");
+    await runKaspaWalletAddress(name);
+  });
+  walletCmd.command("balance <name>").description(`Show balance of a local Kaspa wallet ${UI.maturity("stable")}`).option("--rpc-url <url>", "Kaspa RPC URL", "http://127.0.0.1:16110").option("--json", "Output as JSON", false).action(async (name, options) => {
+    const { runKaspaWalletBalance } = await import("./kaspa-wallet-runner-ORJ5YFKU.js");
+    await runKaspaWalletBalance(name, options);
+  });
+  walletCmd.command("send <from> <to>").description(`Send Kaspa between local wallets ${UI.maturity("stable")}`).option("--amount <kas>", "Amount in KAS to send").option("--dry-run", "Plan but do not sign or broadcast", false).option("--rpc-url <url>", "Kaspa RPC URL", "http://127.0.0.1:16110").action(async (from, to, options) => {
+    const { runKaspaWalletSend } = await import("./kaspa-wallet-runner-ORJ5YFKU.js");
+    await runKaspaWalletSend(from, to, options);
+  });
+  kaspaCmd.command("doctor").description(`Verify local Kaspa L1 environment readiness ${UI.maturity("stable")}`).option("--rpc-url <url>", "Kaspa RPC URL", "http://127.0.0.1:16110").option("--json", "Output as JSON", false).action(async (options) => {
+    const { runKaspaDoctor } = await import("./kaspa-doctor-runner-F2ISPABM.js");
+    await runKaspaDoctor(options);
+  });
+}
+
+// src/commands/bridge.ts
+function registerBridgeCommands(program) {
+  const bridgeCmd = program.command("bridge").description("Kaspa -> Igra bridge developer tools");
+  const localCmd = bridgeCmd.command("local").description("Local bridge entry simulation (deterministic)");
+  localCmd.command("plan").description(`Plan a local bridge entry transaction ${UI.maturity("stable")}`).option("--session <name>", "Link to a specific developer session").option("--from <name>", "Source Kaspa wallet name (overrides session)").option("--to-igra <address>", "Target Igra EVM address (overrides session)").requiredOption("--amount <kas>", "Amount in KAS to bridge").option("--json", "Output as JSON", false).action(async (options) => {
+    const { runBridgeLocalPlan } = await import("./bridge-local-runner-E3LICYYX.js");
+    await runBridgeLocalPlan(options);
+  });
+  localCmd.command("simulate").description(`Simulate a bridge entry with prefix mining ${UI.maturity("stable")}`).option("--session <name>", "Link to a specific developer session").option("--from <name>", "Source Kaspa wallet name (overrides session)").option("--to-igra <address>", "Target Igra EVM address (overrides session)").requiredOption("--amount <kas>", "Amount in KAS to bridge").option("--prefix <hex>", "Prefix to mine for", "abc").option("--json", "Output as JSON", false).action(async (options) => {
+    const { runBridgeLocalSimulate } = await import("./bridge-local-runner-E3LICYYX.js");
+    await runBridgeLocalSimulate(options);
+  });
+  localCmd.command("inspect <txid>").description(`Inspect a local bridge transaction artifact ${UI.maturity("stable")}`).option("--json", "Output as JSON", false).action(async (txid, options) => {
+    const { runBridgeLocalInspect } = await import("./bridge-local-runner-E3LICYYX.js");
+    await runBridgeLocalInspect(txid, options);
+  });
+}
+
+// src/commands/session.ts
+function registerSessionCommands(program) {
+  const sessionCmd = program.command("session").description("L1/L2 developer identity linkage and sessions");
+  sessionCmd.command("create <name>").description(`Create a new L1/L2 session linkage ${UI.maturity("alpha")}`).requiredOption("--l1 <wallet>", "Name of the Kaspa L1 wallet").requiredOption("--l2 <account>", "Name of the Igra L2 account").action(async (name, options) => {
+    const { runSessionCreate } = await import("./session-runner-LDSGDP47.js");
+    await runSessionCreate(name, options);
+  });
+  sessionCmd.command("list").description(`List all configured sessions ${UI.maturity("alpha")}`).action(async () => {
+    const { runSessionList } = await import("./session-runner-LDSGDP47.js");
+    await runSessionList();
+  });
+  sessionCmd.command("status").description(`Show active session linkage ${UI.maturity("alpha")}`).action(async () => {
+    const { runSessionStatus } = await import("./session-runner-LDSGDP47.js");
+    await runSessionStatus();
+  });
+  sessionCmd.command("use <name>").description(`Set the active session ${UI.maturity("alpha")}`).action(async (name) => {
+    const { runSessionUse } = await import("./session-runner-LDSGDP47.js");
+    await runSessionUse(name);
+  });
+}
+
+// src/commands/dashboard.ts
+import pc5 from "picocolors";
+function registerDashboardCommand(program) {
+  program.command("dashboard").description(`Open the HardKas Local Dashboard ${UI.maturity("stable")}`).option("--port <number>", "Port to bind to", "7420").option("--start-server", "Start the dev server if not running", false).action(async (options) => {
+    try {
+      const isRunning = await checkServerRunning(options.port);
+      if (!isRunning) {
+        if (options.startServer) {
+          console.log(pc5.cyan("HardKas Dev Server not found. Starting it now..."));
+          const { runDevServer } = await import("./dev-server-runner-IM5DCDD3.js");
+          await runDevServer({ ...options, open: true, host: "localhost", unsafeExternal: false, json: false });
+        } else {
+          console.log(pc5.red("\nHardKas Dashboard requires the local dev server."));
+          console.log(pc5.dim("\nRun:"));
+          console.log(`  ${pc5.bold("hardkas dev server")}`);
+          console.log(pc5.dim("\nOr:"));
+          console.log(`  ${pc5.bold("hardkas dashboard --start-server")}
+`);
+          process.exit(1);
+        }
+      } else {
+        const open = (await import("open")).default;
+        console.log(pc5.green(`Connecting to existing Dev Server on port ${options.port}...`));
+        await open(`http://localhost:${options.port}`);
+      }
+    } catch (e) {
+      console.error(pc5.red("Error starting dashboard:"), e);
+    }
+  });
+}
+async function checkServerRunning(port) {
+  try {
+    const res = await fetch(`http://localhost:${port}/`, { signal: AbortSignal.timeout(1e3) });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
 // src/program.ts
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import path14 from "path";
 
 // src/commands/lock.ts
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 import { listLocks, clearLock } from "@hardkas/core";
 function registerLockCommands(program) {
   const lockCmd = program.command("lock").description("Manage HardKAS workspace locks");
@@ -5087,10 +5221,10 @@ function registerLockCommands(program) {
         return;
       }
       for (const lock of locks) {
-        const status = lock.isAlive ? pc5.green("live") : pc5.red("STALE");
-        console.log(`  ${pc5.bold(lock.name.padEnd(12))} ${pc5.dim("PID:")} ${lock.metadata.pid.toString().padEnd(6)} ${pc5.dim("State:")} ${status}`);
-        console.log(`    ${pc5.dim("Command:")} ${lock.metadata.command}`);
-        console.log(`    ${pc5.dim("Created:")} ${lock.metadata.createdAt}`);
+        const status = lock.isAlive ? pc6.green("live") : pc6.red("STALE");
+        console.log(`  ${pc6.bold(lock.name.padEnd(12))} ${pc6.dim("PID:")} ${lock.metadata.pid.toString().padEnd(6)} ${pc6.dim("State:")} ${status}`);
+        console.log(`    ${pc6.dim("Command:")} ${lock.metadata.command}`);
+        console.log(`    ${pc6.dim("Created:")} ${lock.metadata.createdAt}`);
         console.log("");
       }
     } catch (e) {
@@ -5105,12 +5239,12 @@ function registerLockCommands(program) {
         const lock = locks.find((l) => l.name === name);
         if (!lock) {
           console.log(`
-  Lock '${name}' is ${pc5.green("FREE")}.
+  Lock '${name}' is ${pc6.green("FREE")}.
 `);
           return;
         }
         UI.header(`Lock Status: ${name}`);
-        console.log(`  State:   ${lock.isAlive ? pc5.green("HELD (live)") : pc5.red("HELD (STALE)")}`);
+        console.log(`  State:   ${lock.isAlive ? pc6.green("HELD (live)") : pc6.red("HELD (STALE)")}`);
         console.log(`  PID:     ${lock.metadata.pid}`);
         console.log(`  Host:    ${lock.metadata.hostname}`);
         console.log(`  Command: ${lock.metadata.command}`);
@@ -5120,7 +5254,7 @@ function registerLockCommands(program) {
       } else {
         UI.header("Lock Summary");
         for (const lock of locks) {
-          console.log(`  ${pc5.bold(lock.name.padEnd(12))}: ${lock.isAlive ? pc5.green("HELD") : pc5.red("STALE")}`);
+          console.log(`  ${pc6.bold(lock.name.padEnd(12))}: ${lock.isAlive ? pc6.green("HELD") : pc6.red("STALE")}`);
         }
         if (locks.length === 0) console.log("  All locks are FREE.");
         console.log("");
@@ -5138,7 +5272,7 @@ function registerLockCommands(program) {
       for (const lock of locks) {
         if (!lock.isAlive) {
           staleCount++;
-          console.log(`  ${pc5.red("\u2717")} Stale lock found: ${pc5.bold(lock.name)} (PID: ${lock.metadata.pid})`);
+          console.log(`  ${pc6.red("\u2717")} Stale lock found: ${pc6.bold(lock.name)} (PID: ${lock.metadata.pid})`);
           console.log(`    Suggestion: Run 'hardkas lock clear ${lock.name} --if-dead'`);
         }
       }
@@ -5212,6 +5346,13 @@ function buildHardkasProgram(options) {
   registerNetworksCommand(program);
   registerLocalnetCommands(program);
   registerDeployCommands(program);
+  registerMetamaskCommands(program);
+  registerDevCommands(program);
+  registerLocalCommands(program);
+  registerKaspaCommands(program);
+  registerBridgeCommands(program);
+  registerSessionCommands(program);
+  registerDashboardCommand(program);
   if (options?.forDocs) {
   }
   return program;