@fiber-pay/cli 0.1.0-rc.4 → 0.1.0-rc.6

package/dist/cli.js

@@ -1,29 +1,229 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { join as join7 } from "path";
-import { Command as Command13 } from "commander";
+import { join as join9 } from "path";
+import { Command as Command14 } from "commander";
 
 // src/commands/binary.ts
-import {
-  DEFAULT_FIBER_VERSION,
-  downloadFiberBinary,
-  getFiberBinaryInfo
-} from "@fiber-pay/node";
+import { DEFAULT_FIBER_VERSION, downloadFiberBinary } from "@fiber-pay/node";
 import { Command } from "commander";
 
+// src/lib/binary-path.ts
+import { dirname, join } from "path";
+import { BinaryManager, getFiberBinaryInfo } from "@fiber-pay/node";
+
+// src/lib/node-runtime-daemon.ts
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+function getCustomBinaryState(binaryPath) {
+  const exists = existsSync(binaryPath);
+  if (!exists) {
+    return { path: binaryPath, ready: false, version: "unknown" };
+  }
+  try {
+    const result = spawnSync(binaryPath, ["--version"], { encoding: "utf-8" });
+    if (result.status !== 0) {
+      return { path: binaryPath, ready: false, version: "unknown" };
+    }
+    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
+    const firstLine = output.split("\n").find((line) => line.trim().length > 0) ?? "unknown";
+    return { path: binaryPath, ready: true, version: firstLine.trim() };
+  } catch {
+    return { path: binaryPath, ready: false, version: "unknown" };
+  }
+}
+function getBinaryVersion(binaryPath) {
+  try {
+    const result = spawnSync(binaryPath, ["--version"], { encoding: "utf-8" });
+    if (result.status !== 0) {
+      return "unknown";
+    }
+    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
+    if (!output) {
+      return "unknown";
+    }
+    const firstLine = output.split("\n").find((line) => line.trim().length > 0);
+    return firstLine?.trim() ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function getCliEntrypoint() {
+  const entrypoint = process.argv[1];
+  if (!entrypoint) {
+    throw new Error("Unable to resolve CLI entrypoint path");
+  }
+  return entrypoint;
+}
+function startRuntimeDaemonFromNode(params) {
+  const cliEntrypoint = getCliEntrypoint();
+  const result = spawnSync(
+    process.execPath,
+    [
+      cliEntrypoint,
+      "--data-dir",
+      params.dataDir,
+      "--rpc-url",
+      params.rpcUrl,
+      "runtime",
+      "start",
+      "--daemon",
+      "--fiber-rpc-url",
+      params.rpcUrl,
+      "--proxy-listen",
+      params.proxyListen,
+      "--state-file",
+      params.stateFilePath,
+      "--alert-logs-base-dir",
+      params.alertLogsBaseDir,
+      "--json"
+    ],
+    { encoding: "utf-8" }
+  );
+  if (result.status === 0) {
+    return { ok: true };
+  }
+  const stderr = (result.stderr ?? "").trim();
+  const stdout = (result.stdout ?? "").trim();
+  const details = stderr || stdout || `exit code ${result.status ?? "unknown"}`;
+  return { ok: false, message: details };
+}
+function stopRuntimeDaemonFromNode(params) {
+  const cliEntrypoint = getCliEntrypoint();
+  spawnSync(
+    process.execPath,
+    [
+      cliEntrypoint,
+      "--data-dir",
+      params.dataDir,
+      "--rpc-url",
+      params.rpcUrl,
+      "runtime",
+      "stop",
+      "--json"
+    ],
+    { encoding: "utf-8" }
+  );
+}
+
+// src/lib/binary-path.ts
+function getProfileBinaryInstallDir(dataDir) {
+  return join(dataDir, "bin");
+}
+function getProfileManagedBinaryPath(dataDir) {
+  return new BinaryManager(getProfileBinaryInstallDir(dataDir)).getBinaryPath();
+}
+function validateConfiguredBinaryPath(binaryPath) {
+  const value = binaryPath.trim();
+  if (!value) {
+    throw new Error("Configured binaryPath cannot be empty");
+  }
+  if (value.includes("\0")) {
+    throw new Error("Configured binaryPath contains an invalid null byte");
+  }
+  return value;
+}
+function resolveBinaryPath(config) {
+  const managedPath = getProfileManagedBinaryPath(config.dataDir);
+  if (config.binaryPath) {
+    const binaryPath2 = validateConfiguredBinaryPath(config.binaryPath);
+    const installDir2 = dirname(binaryPath2);
+    const expectedPath = new BinaryManager(installDir2).getBinaryPath();
+    const managedByBinaryManager = expectedPath === binaryPath2;
+    const source = binaryPath2 === managedPath ? "profile-managed" : "configured-path";
+    return {
+      binaryPath: binaryPath2,
+      installDir: managedByBinaryManager ? installDir2 : null,
+      managedPath,
+      managedByBinaryManager,
+      source
+    };
+  }
+  const installDir = getProfileBinaryInstallDir(config.dataDir);
+  const binaryPath = managedPath;
+  return {
+    binaryPath,
+    installDir,
+    managedPath,
+    managedByBinaryManager: true,
+    source: "profile-managed"
+  };
+}
+function getBinaryManagerInstallDirOrThrow(resolvedBinary) {
+  if (resolvedBinary.installDir) {
+    return resolvedBinary.installDir;
+  }
+  throw new Error(
+    `Configured binaryPath "${resolvedBinary.binaryPath}" is incompatible with BinaryManager-managed path naming. BinaryManager expects "${new BinaryManager(dirname(resolvedBinary.binaryPath)).getBinaryPath()}". Set binaryPath to a standard managed name (fnn/fnn.exe) in the target directory, or unset binaryPath to use the profile-managed binary.`
+  );
+}
+async function getBinaryDetails(config) {
+  const resolvedBinary = resolveBinaryPath(config);
+  const info = resolvedBinary.installDir ? await getFiberBinaryInfo(resolvedBinary.installDir) : getCustomBinaryState(resolvedBinary.binaryPath);
+  return { resolvedBinary, info };
+}
+
 // src/lib/format.ts
 import {
   ChannelState,
   shannonsToCkb,
   toHex
 } from "@fiber-pay/sdk";
+var SHANNONS_PER_CKB = 100000000n;
 function truncateMiddle(value, start = 10, end = 8) {
   if (!value || value.length <= start + end + 3) {
     return value;
   }
   return `${value.slice(0, start)}...${value.slice(-end)}`;
 }
+function sanitizeForTerminal(value) {
+  const input = String(value ?? "");
+  let output = "";
+  for (let i = 0; i < input.length; i++) {
+    const code = input.charCodeAt(i);
+    if (code === 27) {
+      i++;
+      if (i >= input.length) break;
+      if (input.charCodeAt(i) === 91) {
+        i++;
+        while (i < input.length) {
+          const csiCode = input.charCodeAt(i);
+          if (csiCode >= 64 && csiCode <= 126) {
+            break;
+          }
+          i++;
+        }
+      }
+      continue;
+    }
+    if (code === 9 || code === 10 || code === 13) {
+      output += " ";
+      continue;
+    }
+    if (code >= 0 && code <= 8 || code >= 11 && code <= 31) {
+      continue;
+    }
+    if (code >= 127 && code <= 159) {
+      continue;
+    }
+    output += input[i];
+  }
+  return output;
+}
+function formatShannonsAsCkb(shannons, fractionDigits = 8) {
+  const value = typeof shannons === "bigint" ? shannons : BigInt(shannons);
+  const sign = value < 0n ? "-" : "";
+  const abs = value < 0n ? -value : value;
+  const safeDigits = Math.max(0, Math.min(8, Math.trunc(fractionDigits)));
+  const multiplier = 10n ** BigInt(safeDigits);
+  const scaled = (abs * multiplier + SHANNONS_PER_CKB / 2n) / SHANNONS_PER_CKB;
+  const whole = scaled / multiplier;
+  if (safeDigits === 0) {
+    return `${sign}${whole}`;
+  }
+  const fraction = (scaled % multiplier).toString().padStart(safeDigits, "0");
+  return `${sign}${whole}.${fraction}`;
+}
 function parseHexTimestampMs(hexTimestamp) {
   if (!hexTimestamp) return null;
   try {
@@ -284,21 +484,6 @@ function printPeerListHuman(peers) {
     console.log(`${peerId} ${pubkey} ${peer.address}`);
   }
 }
-function printNodeInfoHuman(data) {
-  console.log("Node Info");
-  console.log(`  Node ID:              ${data.nodeId}`);
-  console.log(`  Version:              ${data.version}`);
-  console.log(`  Chain Hash:           ${data.chainHash}`);
-  console.log(`  Funding Address:      ${data.fundingAddress}`);
-  console.log(`  Channels:             ${data.channelCount} (${data.pendingChannelCount} pending)`);
-  console.log(`  Peers:                ${data.peersCount}`);
-  if (data.addresses.length > 0) {
-    console.log("  Addresses:");
-    for (const addr of data.addresses) {
-      console.log(`    - ${addr}`);
-    }
-  }
-}
 
 // src/commands/binary.ts
 function showProgress(progress) {
@@ -311,14 +496,36 @@ function showProgress(progress) {
 function createBinaryCommand(config) {
   const binary = new Command("binary").description("Fiber binary management");
   binary.command("download").option("--version <version>", "Fiber binary version", DEFAULT_FIBER_VERSION).option("--force", "Force re-download").option("--json").action(async (options) => {
+    const resolvedBinary = resolveBinaryPath(config);
+    let installDir;
+    try {
+      installDir = getBinaryManagerInstallDirOrThrow(resolvedBinary);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (options.json) {
+        printJsonError({
+          code: "BINARY_PATH_INCOMPATIBLE",
+          message,
+          recoverable: true,
+          suggestion: "Use `fiber-pay config profile unset binaryPath` or set binaryPath to a standard fnn filename in the target directory."
+        });
+      } else {
+        console.error(`\u274C ${message}`);
+      }
+      process.exit(1);
+    }
     const info = await downloadFiberBinary({
-      installDir: `${config.dataDir}/bin`,
+      installDir,
       version: options.version,
       force: Boolean(options.force),
       onProgress: options.json ? void 0 : showProgress
     });
     if (options.json) {
-      printJsonSuccess(info);
+      printJsonSuccess({
+        ...info,
+        source: resolvedBinary.source,
+        resolvedPath: resolvedBinary.binaryPath
+      });
     } else {
       console.log("\n\u2705 Binary installed successfully!");
       console.log(`  Path:    ${info.path}`);
@@ -327,9 +534,13 @@ function createBinaryCommand(config) {
     }
   });
   binary.command("info").option("--json").action(async (options) => {
-    const info = await getFiberBinaryInfo(`${config.dataDir}/bin`);
+    const { resolvedBinary, info } = await getBinaryDetails(config);
     if (options.json) {
-      printJsonSuccess(info);
+      printJsonSuccess({
+        ...info,
+        source: resolvedBinary.source,
+        resolvedPath: resolvedBinary.binaryPath
+      });
     } else {
       console.log(info.ready ? "\u2705 Binary is ready" : "\u274C Binary not found or not executable");
       console.log(`  Path:    ${info.path}`);
@@ -341,7 +552,7 @@ function createBinaryCommand(config) {
 
 // src/commands/channel.ts
 import { randomUUID } from "crypto";
-import { ckbToShannons } from "@fiber-pay/sdk";
+import { ckbToShannons as ckbToShannons2 } from "@fiber-pay/sdk";
 import { Command as Command2 } from "commander";
 
 // src/lib/async.ts
@@ -353,17 +564,17 @@ function sleep(ms) {
 import { FiberRpcClient } from "@fiber-pay/sdk";
 
 // src/lib/pid.ts
-import { existsSync, readFileSync, unlinkSync, writeFileSync } from "fs";
-import { join } from "path";
+import { existsSync as existsSync2, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { join as join2 } from "path";
 function getPidFilePath(dataDir) {
-  return join(dataDir, "fiber.pid");
+  return join2(dataDir, "fiber.pid");
 }
 function writePidFile(dataDir, pid) {
   writeFileSync(getPidFilePath(dataDir), String(pid));
 }
 function readPidFile(dataDir) {
   const pidPath = getPidFilePath(dataDir);
-  if (!existsSync(pidPath)) return null;
+  if (!existsSync2(pidPath)) return null;
   try {
     return parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
   } catch {
@@ -372,7 +583,7 @@ function readPidFile(dataDir) {
 }
 function removePidFile(dataDir) {
   const pidPath = getPidFilePath(dataDir);
-  if (existsSync(pidPath)) {
+  if (existsSync2(pidPath)) {
     unlinkSync(pidPath);
   }
 }
@@ -386,20 +597,20 @@ function isProcessRunning(pid) {
 }
 
 // src/lib/runtime-meta.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
 function getRuntimePidFilePath(dataDir) {
-  return join2(dataDir, "runtime.pid");
+  return join3(dataDir, "runtime.pid");
 }
 function getRuntimeMetaFilePath(dataDir) {
-  return join2(dataDir, "runtime.meta.json");
+  return join3(dataDir, "runtime.meta.json");
 }
 function writeRuntimePid(dataDir, pid) {
   writeFileSync2(getRuntimePidFilePath(dataDir), String(pid));
 }
 function readRuntimePid(dataDir) {
   const pidPath = getRuntimePidFilePath(dataDir);
-  if (!existsSync2(pidPath)) return null;
+  if (!existsSync3(pidPath)) return null;
   try {
     return Number.parseInt(readFileSync2(pidPath, "utf-8").trim(), 10);
   } catch {
@@ -411,7 +622,7 @@ function writeRuntimeMeta(dataDir, meta) {
 }
 function readRuntimeMeta(dataDir) {
   const metaPath = getRuntimeMetaFilePath(dataDir);
-  if (!existsSync2(metaPath)) return null;
+  if (!existsSync3(metaPath)) return null;
   try {
     return JSON.parse(readFileSync2(metaPath, "utf-8"));
   } catch {
@@ -421,10 +632,10 @@ function readRuntimeMeta(dataDir) {
 function removeRuntimeFiles(dataDir) {
   const pidPath = getRuntimePidFilePath(dataDir);
   const metaPath = getRuntimeMetaFilePath(dataDir);
-  if (existsSync2(pidPath)) {
+  if (existsSync3(pidPath)) {
     unlinkSync2(pidPath);
   }
-  if (existsSync2(metaPath)) {
+  if (existsSync3(metaPath)) {
     unlinkSync2(metaPath);
   }
 }
@@ -457,7 +668,10 @@ function resolveRuntimeProxyUrl(config) {
 }
 function createRpcClient(config) {
   const resolved = resolveRpcEndpoint(config);
-  return new FiberRpcClient({ url: resolved.url });
+  return new FiberRpcClient({
+    url: resolved.url,
+    biscuitToken: config.rpcBiscuitToken
+  });
 }
 function resolveRpcEndpoint(config) {
   const runtimeProxyUrl = resolveRuntimeProxyUrl(config);
@@ -534,23 +748,252 @@ async function waitForRuntimeJobTerminal(runtimeUrl, jobId, timeoutSeconds) {
   throw new Error(`Timed out waiting for runtime job ${jobId}`);
 }
 
+// src/commands/rebalance.ts
+import { ckbToShannons, shannonsToCkb as shannonsToCkb2 } from "@fiber-pay/sdk";
+async function executeRebalance(config, params) {
+  const rpc = await createReadyRpcClient(config);
+  const amountCkb = parseFloat(params.amountInput);
+  const maxFeeCkb = params.maxFeeInput !== void 0 ? parseFloat(params.maxFeeInput) : void 0;
+  const manualHops = params.hops ?? [];
+  if (!Number.isFinite(amountCkb) || amountCkb <= 0) {
+    const message = "Invalid --amount value. Expected a positive CKB amount.";
+    if (params.json) {
+      printJsonError({
+        code: params.errorCode,
+        message,
+        recoverable: true,
+        suggestion: "Provide a positive number, e.g. `--amount 10`.",
+        details: { amount: params.amountInput }
+      });
+    } else {
+      console.error(`Error: ${message}`);
+    }
+    process.exit(1);
+  }
+  if (maxFeeCkb !== void 0 && (!Number.isFinite(maxFeeCkb) || maxFeeCkb < 0 || manualHops.length > 0)) {
+    const message = manualHops.length > 0 ? "--max-fee is only supported in auto rebalance mode (without manual hops)." : "Invalid --max-fee value. Expected a non-negative CKB amount.";
+    if (params.json) {
+      printJsonError({
+        code: params.errorCode,
+        message,
+        recoverable: true,
+        suggestion: manualHops.length > 0 ? "Remove `--max-fee` or run auto mode without manual hops." : "Provide a non-negative number, e.g. `--max-fee 0.01`.",
+        details: { maxFee: params.maxFeeInput, hasManualHops: manualHops.length > 0 }
+      });
+    } else {
+      console.error(`Error: ${message}`);
+    }
+    process.exit(1);
+  }
+  const selfPubkey = (await rpc.nodeInfo()).node_id;
+  const amount = ckbToShannons(amountCkb);
+  const isManual = manualHops.length > 0;
+  let routeHopCount;
+  const result = isManual ? await (async () => {
+    const hopsInfo = [
+      ...manualHops.map((pubkey) => ({ pubkey })),
+      ...manualHops[manualHops.length - 1] === selfPubkey ? [] : [{ pubkey: selfPubkey }]
+    ];
+    const route = await rpc.buildRouter({
+      amount,
+      hops_info: hopsInfo
+    });
+    routeHopCount = route.router_hops.length;
+    return rpc.sendPaymentWithRouter({
+      router: route.router_hops,
+      keysend: true,
+      allow_self_payment: true,
+      dry_run: params.dryRun ? true : void 0
+    });
+  })() : await rpc.sendPayment({
+    target_pubkey: selfPubkey,
+    amount,
+    keysend: true,
+    allow_self_payment: true,
+    max_fee_amount: maxFeeCkb !== void 0 ? ckbToShannons(maxFeeCkb) : void 0,
+    dry_run: params.dryRun ? true : void 0
+  });
+  const payload = {
+    mode: isManual ? "manual" : "auto",
+    selfPubkey,
+    amountCkb,
+    maxFeeCkb: isManual ? void 0 : maxFeeCkb,
+    routeHopCount,
+    paymentHash: result.payment_hash,
+    status: result.status === "Success" ? "success" : result.status === "Failed" ? "failed" : "pending",
+    feeCkb: shannonsToCkb2(result.fee),
+    failureReason: result.failed_error,
+    dryRun: params.dryRun
+  };
+  if (params.json) {
+    printJsonSuccess(payload);
+  } else {
+    console.log(
+      payload.dryRun ? `Rebalance dry-run complete (${payload.mode} route)` : `Rebalance sent (${payload.mode} route)`
+    );
+    console.log(`  Self:   ${payload.selfPubkey}`);
+    console.log(`  Amount: ${payload.amountCkb} CKB`);
+    if (payload.mode === "manual" && payload.routeHopCount !== void 0) {
+      console.log(`  Hops:   ${payload.routeHopCount}`);
+    }
+    console.log(`  Hash:   ${payload.paymentHash}`);
+    console.log(`  Status: ${payload.status}`);
+    console.log(`  Fee:    ${payload.feeCkb} CKB`);
+    if (payload.mode === "auto" && payload.maxFeeCkb !== void 0) {
+      console.log(`  MaxFee: ${payload.maxFeeCkb} CKB`);
+    }
+    if (payload.failureReason) {
+      console.log(`  Error:  ${payload.failureReason}`);
+    }
+  }
+}
+function registerPaymentRebalanceCommand(parent, config) {
+  parent.command("rebalance").description("Technical rebalance command mapped to payment-layer circular self-payment").requiredOption("--amount <ckb>", "Amount in CKB to rebalance").option("--max-fee <ckb>", "Maximum fee in CKB (auto mode only)").option(
+    "--hops <pubkeys>",
+    "Comma-separated peer pubkeys for manual route mode (self pubkey appended automatically)"
+  ).option("--dry-run", "Simulate route/payment and return estimated result").option("--json").action(async (options) => {
+    const hasHopsOption = typeof options.hops === "string";
+    const manualHops = hasHopsOption ? options.hops.split(",").map((item) => item.trim()).filter(Boolean) : [];
+    if (hasHopsOption && manualHops.length === 0) {
+      const message = "Invalid --hops value. Expected a non-empty comma-separated list of pubkeys.";
+      if (options.json) {
+        printJsonError({
+          code: "PAYMENT_REBALANCE_INPUT_INVALID",
+          message,
+          recoverable: true,
+          suggestion: "Provide pubkeys like `--hops 0xabc...,0xdef...`.",
+          details: { hops: options.hops }
+        });
+      } else {
+        console.error(`Error: ${message}`);
+      }
+      process.exit(1);
+    }
+    await executeRebalance(config, {
+      amountInput: options.amount,
+      maxFeeInput: options.maxFee,
+      hops: manualHops,
+      dryRun: Boolean(options.dryRun),
+      json: Boolean(options.json),
+      errorCode: "PAYMENT_REBALANCE_INPUT_INVALID"
+    });
+  });
+}
+function registerChannelRebalanceCommand(parent, config) {
+  parent.command("rebalance").description("High-level channel rebalance wrapper using payment-layer orchestration").requiredOption("--amount <ckb>", "Amount in CKB to rebalance").option("--from-channel <channelId>", "Source-biased channel id (optional)").option("--to-channel <channelId>", "Destination-biased channel id (optional)").option("--max-fee <ckb>", "Maximum fee in CKB (auto mode only)").option("--dry-run", "Simulate route/payment and return estimated result").option("--json").action(async (options) => {
+    const json = Boolean(options.json);
+    const fromChannelId = options.fromChannel;
+    const toChannelId = options.toChannel;
+    if (fromChannelId && !toChannelId || !fromChannelId && toChannelId) {
+      const message = "Both --from-channel and --to-channel must be provided together for guided channel rebalance.";
+      if (json) {
+        printJsonError({
+          code: "CHANNEL_REBALANCE_INPUT_INVALID",
+          message,
+          recoverable: true,
+          suggestion: "Provide both channel ids, or provide neither to run auto mode.",
+          details: { fromChannel: fromChannelId, toChannel: toChannelId }
+        });
+      } else {
+        console.error(`Error: ${message}`);
+      }
+      process.exit(1);
+    }
+    let guidedHops;
+    if (fromChannelId && toChannelId) {
+      const rpc = await createReadyRpcClient(config);
+      const channels = (await rpc.listChannels({ include_closed: true })).channels;
+      const fromChannel = channels.find((item) => item.channel_id === fromChannelId);
+      const toChannel = channels.find((item) => item.channel_id === toChannelId);
+      if (!fromChannel || !toChannel) {
+        const message = "Invalid channel selection: source/target channel id not found.";
+        if (json) {
+          printJsonError({
+            code: "CHANNEL_REBALANCE_INPUT_INVALID",
+            message,
+            recoverable: true,
+            suggestion: "Run `channel list --json` and retry with valid channel ids.",
+            details: { fromChannel: fromChannelId, toChannel: toChannelId }
+          });
+        } else {
+          console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+      }
+      if (fromChannel.peer_id === toChannel.peer_id) {
+        const message = "Source and target channels point to the same peer; choose two different channel peers.";
+        if (json) {
+          printJsonError({
+            code: "CHANNEL_REBALANCE_INPUT_INVALID",
+            message,
+            recoverable: true,
+            suggestion: "Select channels with different peer ids for guided rebalance.",
+            details: {
+              fromChannel: fromChannelId,
+              toChannel: toChannelId,
+              peerId: fromChannel.peer_id
+            }
+          });
+        } else {
+          console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+      }
+      const peers = (await rpc.listPeers()).peers;
+      const pubkeyByPeerId = new Map(peers.map((peer) => [peer.peer_id, peer.pubkey]));
+      const fromPubkey = pubkeyByPeerId.get(fromChannel.peer_id);
+      const toPubkey = pubkeyByPeerId.get(toChannel.peer_id);
+      if (!fromPubkey || !toPubkey) {
+        const message = "Unable to resolve selected channel peer_id to pubkey for guided rebalance route.";
+        if (json) {
+          printJsonError({
+            code: "CHANNEL_REBALANCE_INPUT_INVALID",
+            message,
+            recoverable: true,
+            suggestion: "Ensure both peers are connected (`peer list --json`) and retry guided mode, or use `payment rebalance --hops`.",
+            details: {
+              fromChannel: fromChannelId,
+              toChannel: toChannelId,
+              fromPeerId: fromChannel.peer_id,
+              toPeerId: toChannel.peer_id,
+              resolvedPeers: peers.length
+            }
+          });
+        } else {
+          console.error(`Error: ${message}`);
+        }
+        process.exit(1);
+      }
+      guidedHops = [fromPubkey, toPubkey];
+    }
+    await executeRebalance(config, {
+      amountInput: options.amount,
+      maxFeeInput: options.maxFee,
+      hops: guidedHops,
+      dryRun: Boolean(options.dryRun),
+      json,
+      errorCode: "CHANNEL_REBALANCE_INPUT_INVALID"
+    });
+  });
+}
+
 // src/commands/channel.ts
 function createChannelCommand(config) {
   const channel = new Command2("channel").description("Channel lifecycle and status commands");
-  channel.command("list").option("--state <state>").option("--peer <peerId>").option("--include-closed").option("--raw").option("--json").action(async (options) => {
+  channel.command("list").option("--state <state>").option("--peer <peerId>").option("--include-closed").option("--json").action(async (options) => {
     const rpc = await createReadyRpcClient(config);
     const stateFilter = parseChannelState(options.state);
     const response = await rpc.listChannels(
       options.peer ? { peer_id: options.peer, include_closed: Boolean(options.includeClosed) } : { include_closed: Boolean(options.includeClosed) }
     );
     const channels = stateFilter ? response.channels.filter((item) => item.state.state_name === stateFilter) : response.channels;
-    if (options.raw || options.json) {
+    if (options.json) {
       printJsonSuccess({ channels, count: channels.length });
     } else {
       printChannelListHuman(channels);
     }
   });
-  channel.command("get").argument("<channelId>").option("--raw").option("--json").action(async (channelId, options) => {
+  channel.command("get").argument("<channelId>").option("--json").action(async (channelId, options) => {
     const rpc = await createReadyRpcClient(config);
     const response = await rpc.listChannels({ include_closed: true });
     const found = response.channels.find((item) => item.channel_id === channelId);
@@ -568,7 +1011,7 @@ function createChannelCommand(config) {
       }
       process.exit(1);
     }
-    if (options.raw || options.json) {
+    if (options.json) {
       printJsonSuccess(found);
     } else {
       printChannelDetailHuman(found);
@@ -708,7 +1151,7 @@ function createChannelCommand(config) {
           peerId,
           openChannelParams: {
             peer_id: peerId,
-            funding_amount: ckbToShannons(fundingCkb),
+            funding_amount: ckbToShannons2(fundingCkb),
             public: !options.private
           },
           waitForReady: false
@@ -741,7 +1184,7 @@ function createChannelCommand(config) {
     }
     const result = await rpc.openChannel({
       peer_id: peerId,
-      funding_amount: ckbToShannons(fundingCkb),
+      funding_amount: ckbToShannons2(fundingCkb),
       public: !options.private
     });
     const payload = { temporaryChannelId: result.temporary_channel_id, peer: peerId, fundingCkb };
@@ -765,7 +1208,7 @@ function createChannelCommand(config) {
           action: "accept",
           acceptChannelParams: {
             temporary_channel_id: temporaryChannelId,
-            funding_amount: ckbToShannons(fundingCkb)
+            funding_amount: ckbToShannons2(fundingCkb)
           }
         },
         options: {
@@ -793,7 +1236,7 @@ function createChannelCommand(config) {
     }
     const result = await rpc.acceptChannel({
       temporary_channel_id: temporaryChannelId,
-      funding_amount: ckbToShannons(fundingCkb)
+      funding_amount: ckbToShannons2(fundingCkb)
     });
     const payload = { channelId: result.channel_id, temporaryChannelId, fundingCkb };
     if (json) {
@@ -818,7 +1261,7 @@ function createChannelCommand(config) {
             channel_id: channelId,
             force: Boolean(options.force)
           },
-          waitForClosed: false
+          waitForClosed: Boolean(options.force)
         },
         options: {
           idempotencyKey: `shutdown:channel:${channelId}`
@@ -903,6 +1346,7 @@ function createChannelCommand(config) {
       console.log(`  Channel ID: ${payload.channelId}`);
     }
   });
+  registerChannelRebalanceCommand(channel, config);
   channel.command("update").argument("<channelId>").option("--enabled <enabled>").option("--tlc-expiry-delta <ms>").option("--tlc-minimum-value <shannonsHex>").option("--tlc-fee-proportional-millionths <value>").option("--json").action(async (channelId, options) => {
     const rpc = await createReadyRpcClient(config);
     const json = Boolean(options.json);
@@ -956,13 +1400,13 @@ function createChannelCommand(config) {
 }
 
 // src/commands/config.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
 import { Command as Command3 } from "commander";
 import { parseDocument, stringify as yamlStringify } from "yaml";
 
 // src/lib/config.ts
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join4 } from "path";
 
 // src/lib/config-templates.ts
 var TESTNET_CONFIG_TEMPLATE_V071 = `# This configuration file only contains the necessary configurations for the testnet deployment.
@@ -1121,7 +1565,7 @@ var DEFAULT_DATA_DIR = `${process.env.HOME}/.fiber-pay`;
 var DEFAULT_RPC_URL = "http://127.0.0.1:8227";
 var DEFAULT_NETWORK = "testnet";
 function getConfigPath(dataDir) {
-  return join3(dataDir, "config.yml");
+  return join4(dataDir, "config.yml");
 }
 function parseNetworkFromConfig(configContent) {
   const match = configContent.match(/^\s*chain:\s*(testnet|mainnet)\s*$/m);
@@ -1153,11 +1597,11 @@ function parseCkbRpcUrlFromConfig(configContent) {
   return match?.[1]?.trim() || void 0;
 }
 function getProfilePath(dataDir) {
-  return join3(dataDir, "profile.json");
+  return join4(dataDir, "profile.json");
 }
 function loadProfileConfig(dataDir) {
   const profilePath = getProfilePath(dataDir);
-  if (!existsSync3(profilePath)) return void 0;
+  if (!existsSync4(profilePath)) return void 0;
   try {
     const raw = readFileSync3(profilePath, "utf-8");
     return JSON.parse(raw);
@@ -1166,7 +1610,7 @@ function loadProfileConfig(dataDir) {
   }
 }
 function saveProfileConfig(dataDir, profile) {
-  if (!existsSync3(dataDir)) {
+  if (!existsSync4(dataDir)) {
     mkdirSync(dataDir, { recursive: true });
   }
   const profilePath = getProfilePath(dataDir);
@@ -1175,11 +1619,11 @@ function saveProfileConfig(dataDir, profile) {
 }
 function writeNetworkConfigFile(dataDir, network, options = {}) {
   const configPath = getConfigPath(dataDir);
-  const alreadyExists = existsSync3(configPath);
+  const alreadyExists = existsSync4(configPath);
   if (alreadyExists && !options.force) {
     return { path: configPath, created: false, overwritten: false };
   }
-  if (!existsSync3(dataDir)) {
+  if (!existsSync4(dataDir)) {
     mkdirSync(dataDir, { recursive: true });
   }
   let content = getConfigTemplate(network);
@@ -1205,7 +1649,7 @@ function writeNetworkConfigFile(dataDir, network, options = {}) {
 }
 function ensureNodeConfigFile(dataDir, network) {
   const configPath = getConfigPath(dataDir);
-  if (!existsSync3(configPath)) {
+  if (!existsSync4(configPath)) {
     writeNetworkConfigFile(dataDir, network);
   }
   return configPath;
@@ -1214,7 +1658,7 @@ function getEffectiveConfig(explicitFlags2) {
   const dataDir = process.env.FIBER_DATA_DIR || DEFAULT_DATA_DIR;
   const dataDirSource = explicitFlags2?.has("dataDir") ? "cli" : process.env.FIBER_DATA_DIR ? "env" : "default";
   const configPath = getConfigPath(dataDir);
-  const configExists = existsSync3(configPath);
+  const configExists = existsSync4(configPath);
   const configContent = configExists ? readFileSync3(configPath, "utf-8") : void 0;
   const profile = loadProfileConfig(dataDir);
   const cliNetwork = explicitFlags2?.has("network") ? process.env.FIBER_NETWORK : void 0;
@@ -1227,6 +1671,10 @@ function getEffectiveConfig(explicitFlags2) {
   const fileRpcUrl = configContent ? parseRpcUrlFromConfig(configContent) : void 0;
   const rpcUrl = cliRpcUrl || envRpcUrl || fileRpcUrl || DEFAULT_RPC_URL;
   const rpcUrlSource = cliRpcUrl ? "cli" : envRpcUrl ? "env" : fileRpcUrl ? "config" : "default";
+  const cliRpcBiscuitToken = explicitFlags2?.has("rpcBiscuitToken") ? process.env.FIBER_RPC_BISCUIT_TOKEN : void 0;
+  const envRpcBiscuitToken = !explicitFlags2?.has("rpcBiscuitToken") ? process.env.FIBER_RPC_BISCUIT_TOKEN : void 0;
+  const rpcBiscuitToken = cliRpcBiscuitToken || envRpcBiscuitToken || void 0;
+  const rpcBiscuitTokenSource = cliRpcBiscuitToken ? "cli" : envRpcBiscuitToken ? "env" : "unset";
   const cliBinaryPath = explicitFlags2?.has("binaryPath") ? process.env.FIBER_BINARY_PATH : void 0;
   const profileBinaryPath = profile?.binaryPath;
   const envBinaryPath = !explicitFlags2?.has("binaryPath") ? process.env.FIBER_BINARY_PATH : void 0;
@@ -1253,6 +1701,7 @@ function getEffectiveConfig(explicitFlags2) {
       configPath,
       network,
       rpcUrl,
+      rpcBiscuitToken,
       keyPassword,
       ckbRpcUrl,
       runtimeProxyListen
@@ -1262,6 +1711,7 @@ function getEffectiveConfig(explicitFlags2) {
       configPath: "derived",
       network: networkSource,
       rpcUrl: rpcUrlSource,
+      rpcBiscuitToken: rpcBiscuitTokenSource,
       ckbRpcUrl: ckbRpcUrlSource,
       runtimeProxyListen: runtimeProxyListenSource
     }
@@ -1356,7 +1806,7 @@ function parseTypedValue(raw, valueType) {
   return raw;
 }
 function ensureConfigFileOrExit(configPath, json) {
-  if (!existsSync4(configPath)) {
+  if (!existsSync5(configPath)) {
     const msg = `Config file not found: ${configPath}. Run \`fiber-pay config init\` first.`;
     if (json) {
       printJsonError({
@@ -1728,7 +2178,7 @@ function createConfigCommand(_config) {
 }
 
 // src/commands/graph.ts
-import { shannonsToCkb as shannonsToCkb2, toHex as toHex2 } from "@fiber-pay/sdk";
+import { shannonsToCkb as shannonsToCkb3, toHex as toHex2 } from "@fiber-pay/sdk";
 import { Command as Command4 } from "commander";
 function printGraphNodeListHuman(nodes) {
   if (nodes.length === 0) {
@@ -1743,7 +2193,7 @@ function printGraphNodeListHuman(nodes) {
     const nodeId = truncateMiddle(node.node_id, 10, 8).padEnd(22, " ");
     const alias = (node.node_name || "(unnamed)").slice(0, 20).padEnd(20, " ");
     const version = (node.version || "?").slice(0, 10).padEnd(10, " ");
-    const minFunding = shannonsToCkb2(node.auto_accept_min_ckb_funding_amount).toString().padStart(12, " ");
+    const minFunding = shannonsToCkb3(node.auto_accept_min_ckb_funding_amount).toString().padStart(12, " ");
     const age = formatAge(parseHexTimestampMs(node.timestamp));
     console.log(`${nodeId} ${alias} ${version} ${minFunding} ${age}`);
   }
@@ -1765,7 +2215,7 @@ function printGraphChannelListHuman(channels) {
     const outpoint = ch.channel_outpoint ? truncateMiddle(`${ch.channel_outpoint.tx_hash}:${ch.channel_outpoint.index}`, 10, 8) : "n/a";
     const n1 = truncateMiddle(ch.node1, 10, 8).padEnd(22, " ");
     const n2 = truncateMiddle(ch.node2, 10, 8).padEnd(22, " ");
-    const capacity = `${shannonsToCkb2(ch.capacity)} CKB`.padStart(12, " ");
+    const capacity = `${shannonsToCkb3(ch.capacity)} CKB`.padStart(12, " ");
     const age = formatAge(parseHexTimestampMs(ch.created_timestamp));
     console.log(`${outpoint.padEnd(22, " ")} ${n1} ${n2} ${capacity} ${age}`);
   }
@@ -1810,7 +2260,7 @@ Next cursor: ${result.last_cursor}`);
 }
 
 // src/commands/invoice.ts
-import { ckbToShannons as ckbToShannons2, randomBytes32, shannonsToCkb as shannonsToCkb3, toHex as toHex3 } from "@fiber-pay/sdk";
+import { ckbToShannons as ckbToShannons3, randomBytes32, shannonsToCkb as shannonsToCkb4, toHex as toHex3 } from "@fiber-pay/sdk";
 import { Command as Command5 } from "commander";
 function createInvoiceCommand(config) {
   const invoice = new Command5("invoice").description("Invoice lifecycle and status commands");
@@ -1839,7 +2289,7 @@ function createInvoiceCommand(config) {
         params: {
           action: "create",
           newInvoiceParams: {
-            amount: ckbToShannons2(amountCkb),
+            amount: ckbToShannons3(amountCkb),
             currency,
             description: options.description,
             expiry: toHex3(expirySeconds),
@@ -1876,7 +2326,7 @@ function createInvoiceCommand(config) {
       }
     }
     const result = await rpc.newInvoice({
-      amount: ckbToShannons2(amountCkb),
+      amount: ckbToShannons3(amountCkb),
       currency,
       description: options.description,
       expiry: toHex3(expirySeconds),
@@ -1908,7 +2358,7 @@ function createInvoiceCommand(config) {
       paymentHash,
       status: result.status,
       invoice: result.invoice_address,
-      amountCkb: result.invoice.amount ? shannonsToCkb3(result.invoice.amount) : void 0,
+      amountCkb: result.invoice.amount ? shannonsToCkb4(result.invoice.amount) : void 0,
       currency: result.invoice.currency,
       description: metadata.description,
       createdAt: createdAtMs ? new Date(createdAtMs).toISOString() : result.invoice.data.timestamp,
@@ -2028,19 +2478,104 @@ function createInvoiceCommand(config) {
 }
 
 // src/commands/job.ts
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { Command as Command6 } from "commander";
 
 // src/lib/log-files.ts
-import { closeSync, createReadStream, existsSync as existsSync5, openSync, readSync, statSync } from "fs";
-import { join as join4 } from "path";
-function resolvePersistedLogPaths(dataDir, meta) {
+import {
+  appendFileSync,
+  closeSync,
+  createReadStream,
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync2,
+  openSync,
+  readdirSync,
+  readSync,
+  statSync
+} from "fs";
+import { join as join5 } from "path";
+var DATE_DIR_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function todayDateString() {
+  const now = /* @__PURE__ */ new Date();
+  const y = now.getUTCFullYear();
+  const m = String(now.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(now.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+function validateLogDate(date) {
+  const value = date.trim();
+  if (!DATE_DIR_PATTERN.test(value)) {
+    throw new Error(`Invalid date '${value}'. Expected format YYYY-MM-DD.`);
+  }
+  if (value.includes("/") || value.includes("\\") || value.includes("..")) {
+    throw new Error(`Invalid date '${value}'. Path separators or '..' are not allowed.`);
+  }
+  return value;
+}
+function resolveLogDirForDate(dataDir, date) {
+  return resolveLogDirForDateWithOptions(dataDir, date, {});
+}
+function resolveLogDirForDateWithOptions(dataDir, date, options) {
+  const dateStr = date ?? todayDateString();
+  const logsBaseDir = options.logsBaseDir ?? join5(dataDir, "logs");
+  if (date !== void 0) {
+    validateLogDate(dateStr);
+  }
+  const dir = join5(logsBaseDir, dateStr);
+  const ensureExists = options.ensureExists ?? true;
+  if (ensureExists) {
+    mkdirSync2(dir, { recursive: true });
+  }
+  return dir;
+}
+function resolvePersistedLogPaths(dataDir, meta, date) {
+  const logsBaseDir = meta?.logsBaseDir ?? join5(dataDir, "logs");
+  if (date) {
+    const dir2 = resolveLogDirForDateWithOptions(dataDir, date, {
+      logsBaseDir,
+      ensureExists: false
+    });
+    return {
+      runtimeAlerts: join5(dir2, "runtime.alerts.jsonl"),
+      fnnStdout: join5(dir2, "fnn.stdout.log"),
+      fnnStderr: join5(dir2, "fnn.stderr.log")
+    };
+  }
+  if (meta?.alertLogFilePath || meta?.fnnStdoutLogPath || meta?.fnnStderrLogPath) {
+    const defaultDir = resolveLogDirForDateWithOptions(dataDir, void 0, {
+      logsBaseDir,
+      ensureExists: false
+    });
+    return {
+      runtimeAlerts: meta.alertLogFilePath ?? join5(defaultDir, "runtime.alerts.jsonl"),
+      fnnStdout: meta.fnnStdoutLogPath ?? join5(defaultDir, "fnn.stdout.log"),
+      fnnStderr: meta.fnnStderrLogPath ?? join5(defaultDir, "fnn.stderr.log")
+    };
+  }
+  const dir = resolveLogDirForDateWithOptions(dataDir, void 0, {
+    logsBaseDir,
+    ensureExists: false
+  });
   return {
-    runtimeAlerts: meta?.alertLogFilePath ?? join4(dataDir, "logs", "runtime.alerts.jsonl"),
-    fnnStdout: meta?.fnnStdoutLogPath ?? join4(dataDir, "logs", "fnn.stdout.log"),
-    fnnStderr: meta?.fnnStderrLogPath ?? join4(dataDir, "logs", "fnn.stderr.log")
+    runtimeAlerts: join5(dir, "runtime.alerts.jsonl"),
+    fnnStdout: join5(dir, "fnn.stdout.log"),
+    fnnStderr: join5(dir, "fnn.stderr.log")
   };
 }
+function listLogDates(dataDir, logsBaseDir) {
+  const logsDir = logsBaseDir ?? join5(dataDir, "logs");
+  if (!existsSync6(logsDir)) {
+    return [];
+  }
+  const entries = readdirSync(logsDir, { withFileTypes: true });
+  const dates = entries.filter((entry) => entry.isDirectory() && DATE_DIR_PATTERN.test(entry.name)).map((entry) => entry.name);
+  dates.sort((a, b) => a > b ? -1 : a < b ? 1 : 0);
+  return dates;
+}
+function appendToTodayLog(dataDir, filename, text) {
+  const dir = resolveLogDirForDate(dataDir);
+  appendFileSync(join5(dir, filename), text, "utf-8");
+}
 function resolvePersistedLogTargets(paths, source) {
   const all = [
     {
@@ -2065,7 +2600,7 @@ function resolvePersistedLogTargets(paths, source) {
   return all.filter((target) => target.source === source);
 }
 function readLastLines(filePath, maxLines) {
-  if (!existsSync5(filePath)) {
+  if (!existsSync6(filePath)) {
     return [];
   }
   if (!Number.isFinite(maxLines) || maxLines <= 0) {
@@ -2109,7 +2644,7 @@ function readLastLines(filePath, maxLines) {
   }
 }
 async function readAppendedLines(filePath, offset, remainder = "") {
-  if (!existsSync5(filePath)) {
+  if (!existsSync6(filePath)) {
     return { lines: [], nextOffset: 0, remainder: "" };
   }
   const size = statSync(filePath).size;
@@ -2209,10 +2744,11 @@ function createJobCommand(config) {
       console.log(`    ${JSON.stringify(payload.result)}`);
     }
   });
-  job.command("trace").argument("<jobId>").option("--tail <n>", "Max lines to inspect per log file", "400").option("--json").action(async (jobId, options) => {
+  job.command("trace").argument("<jobId>").option("--tail <n>", "Max lines to inspect per log file", "400").option("--date <YYYY-MM-DD>", "Date of log directory to search (default: today UTC)").option("--json").action(async (jobId, options) => {
     const json = Boolean(options.json);
     const tailInput = Number.parseInt(String(options.tail ?? "400"), 10);
     const tail = Number.isFinite(tailInput) && tailInput > 0 ? tailInput : 400;
+    const date = options.date ? String(options.date).trim() : void 0;
     const runtimeUrl = getRuntimeUrlOrExit(config, json);
     const jobResponse = await fetch(`${runtimeUrl}/jobs/${jobId}`);
     if (!jobResponse.ok) {
@@ -2226,7 +2762,24 @@ function createJobCommand(config) {
     const eventsPayload = await eventsResponse.json();
     const tokens = collectTraceTokens(jobRecord, eventsPayload.events);
     const meta = readRuntimeMeta(config.dataDir);
-    const logPaths = resolvePersistedLogPaths(config.dataDir, meta);
+    let logPaths;
+    try {
+      logPaths = resolvePersistedLogPaths(config.dataDir, meta, date);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Invalid --date value.";
+      if (json) {
+        printJsonError({
+          code: "JOB_TRACE_DATE_INVALID",
+          message,
+          recoverable: true,
+          suggestion: "Retry with --date in YYYY-MM-DD format.",
+          details: { date }
+        });
+      } else {
+        console.error(`Error: ${message}`);
+      }
+      process.exit(1);
+    }
     const runtimeAlertMatches = collectRelatedLines(logPaths.runtimeAlerts, tokens, tail);
     const fnnStdoutMatches = collectRelatedLines(logPaths.fnnStdout, tokens, tail);
     const fnnStderrMatches = collectRelatedLines(logPaths.fnnStderr, tokens, tail);
@@ -2429,7 +2982,7 @@ function collectStructuredTokens(set, input, depth = 0) {
   }
 }
 function collectRelatedLines(filePath, tokens, tail) {
-  if (!existsSync6(filePath)) {
+  if (!existsSync7(filePath)) {
     return [];
   }
   const lines = readLastLines(filePath, tail);
@@ -2445,7 +2998,7 @@ function collectRelatedLines(filePath, tokens, tail) {
 function printTraceSection(title, filePath, lines) {
   console.log(`
 ${title}: ${filePath}`);
-  if (!existsSync6(filePath)) {
+  if (!existsSync7(filePath)) {
     console.log("  (file not found)");
     return;
   }
@@ -2459,7 +3012,8 @@ ${title}: ${filePath}`);
 }
 
 // src/commands/logs.ts
-import { existsSync as existsSync7, statSync as statSync2 } from "fs";
+import { existsSync as existsSync8, statSync as statSync2 } from "fs";
+import { join as join6 } from "path";
 import { formatRuntimeAlert } from "@fiber-pay/runtime";
 import { Command as Command7 } from "commander";
 var ALLOWED_SOURCES = /* @__PURE__ */ new Set([
@@ -2468,6 +3022,7 @@ var ALLOWED_SOURCES = /* @__PURE__ */ new Set([
   "fnn-stdout",
   "fnn-stderr"
 ]);
+var DATE_DIR_PATTERN2 = /^\d{4}-\d{2}-\d{2}$/;
 function parseRuntimeAlertLine(line) {
   try {
     const parsed = JSON.parse(line);
@@ -2493,9 +3048,45 @@ function coerceJsonLineForOutput(source, line) {
   return parseRuntimeAlertLine(line) ?? line;
 }
 function createLogsCommand(config) {
-  return new Command7("logs").alias("log").description("View persisted runtime/fnn logs").option("--source <source>", "Log source: all|runtime|fnn-stdout|fnn-stderr", "all").option("--tail <n>", "Number of recent lines per source", "80").option("--follow", "Keep streaming appended log lines (human output mode only)").option("--interval-ms <ms>", "Polling interval for --follow mode", "1000").option("--json").action(async (options) => {
+  return new Command7("logs").alias("log").description("View persisted runtime/fnn logs").option("--source <source>", "Log source: all|runtime|fnn-stdout|fnn-stderr", "all").option("--tail <n>", "Number of recent lines per source", "80").option("--date <YYYY-MM-DD>", "Date of log directory to read (default: today UTC)").option("--list-dates", "List available log dates and exit").option("--follow", "Keep streaming appended log lines (human output mode only)").option("--interval-ms <ms>", "Polling interval for --follow mode", "1000").option("--json").action(async (options) => {
     const json = Boolean(options.json);
     const follow = Boolean(options.follow);
+    const listDates = Boolean(options.listDates);
+    const date = options.date ? String(options.date).trim() : void 0;
+    const meta = readRuntimeMeta(config.dataDir);
+    if (follow && date) {
+      const message = "--follow cannot be used with --date. --follow only streams today's logs.";
+      if (json) {
+        printJsonError({
+          code: "LOG_FOLLOW_DATE_UNSUPPORTED",
+          message,
+          recoverable: true,
+          suggestion: "Remove --date or remove --follow and retry."
+        });
+      } else {
+        console.error(`Error: ${message}`);
+      }
+      process.exit(1);
+    }
+    if (listDates) {
+      const logsDir = meta?.logsBaseDir ?? join6(config.dataDir, "logs");
+      const dates = listLogDates(config.dataDir, logsDir);
+      if (json) {
+        printJsonSuccess({ dates, logsDir });
+      } else {
+        if (dates.length === 0) {
+          console.log("No log dates found.");
+        } else {
+          console.log(`Log dates (${dates.length}):`);
+          for (const date2 of dates) {
+            console.log(`  ${date2}`);
+          }
+          console.log(`
+Logs directory: ${logsDir}`);
+        }
+      }
+      return;
+    }
     const sourceInput = String(options.source ?? "all").trim().toLowerCase();
     if (json && follow) {
       const message = "--follow is not supported with --json. Use human mode for streaming logs.";
@@ -2527,18 +3118,36 @@ function createLogsCommand(config) {
     const tail = Number.isFinite(tailInput) && tailInput > 0 ? tailInput : 80;
     const intervalInput = Number.parseInt(String(options.intervalMs ?? "1000"), 10);
     const intervalMs = Number.isFinite(intervalInput) && intervalInput > 0 ? intervalInput : 1e3;
-    const meta = readRuntimeMeta(config.dataDir);
-    const paths = resolvePersistedLogPaths(config.dataDir, meta);
+    let paths;
+    try {
+      paths = resolvePersistedLogPaths(config.dataDir, meta, date);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Invalid --date value.";
+      if (json) {
+        printJsonError({
+          code: "LOG_DATE_INVALID",
+          message,
+          recoverable: true,
+          suggestion: "Retry with --date in YYYY-MM-DD format.",
+          details: { date }
+        });
+      } else {
+        console.error(`Error: ${message}`);
+      }
+      process.exit(1);
+    }
     const targets = resolvePersistedLogTargets(paths, source);
-    if (source !== "all" && targets.length === 1 && !existsSync7(targets[0].path)) {
-      const message = `Log file not found for source ${source}: ${targets[0].path}`;
+    const displayDate = date ?? inferDateFromPaths(paths);
+    if (source !== "all" && targets.length === 1 && !existsSync8(targets[0].path)) {
+      const dateLabel = displayDate ? ` on ${displayDate}` : "";
+      const message = `Log file not found for source ${source}${dateLabel}: ${targets[0].path}`;
       if (json) {
         printJsonError({
           code: "LOG_FILE_NOT_FOUND",
           message,
           recoverable: true,
-          suggestion: "Start node/runtime or generate activity, then retry logs command.",
-          details: { source, path: targets[0].path }
+          suggestion: "Start node/runtime or generate activity, then retry logs command. Use --list-dates to see available dates.",
+          details: { source, date: displayDate ?? null, path: targets[0].path }
         });
       } else {
         console.error(`Error: ${message}`);
@@ -2547,7 +3156,7 @@ function createLogsCommand(config) {
     }
     const entries = [];
     for (const target of targets) {
-      const exists = existsSync7(target.path);
+      const exists = existsSync8(target.path);
       let lines = [];
       if (exists) {
         try {
@@ -2582,6 +3191,7 @@ function createLogsCommand(config) {
       printJsonSuccess({
         source,
         tail,
+        date: displayDate ?? null,
         entries: entries.map((entry) => ({
           source: entry.source,
           title: entry.title,
@@ -2593,7 +3203,8 @@ function createLogsCommand(config) {
       });
       return;
     }
-    console.log(`Logs (source: ${source}, tail: ${tail})`);
+    const headerDate = displayDate ? `, date: ${displayDate}` : "";
+    console.log(`Logs (source: ${source}${headerDate}, tail: ${tail})`);
     for (const entry of entries) {
       console.log(`
 ${entry.title}: ${entry.path}`);
@@ -2647,7 +3258,7 @@ Following logs (interval: ${intervalMs}ms). Press Ctrl+C to stop.`);
           for (const target of targets) {
             const state = states.get(target.source);
             if (!state) continue;
-            if (!existsSync7(state.path)) {
+            if (!existsSync8(state.path)) {
               state.offset = 0;
               state.remainder = "";
               continue;
@@ -2678,28 +3289,199 @@ Following logs (interval: ${intervalMs}ms). Press Ctrl+C to stop.`);
     });
   });
 }
+function inferDateFromPaths(paths) {
+  const candidate = paths.runtimeAlerts.split("/").at(-2);
+  if (!candidate || !DATE_DIR_PATTERN2.test(candidate)) {
+    return void 0;
+  }
+  const stdoutDate = paths.fnnStdout.split("/").at(-2);
+  const stderrDate = paths.fnnStderr.split("/").at(-2);
+  if (stdoutDate !== candidate || stderrDate !== candidate) {
+    return void 0;
+  }
+  return candidate;
+}
 
 // src/commands/node.ts
-import { nodeIdToPeerId as nodeIdToPeerId2, scriptToAddress as scriptToAddress2 } from "@fiber-pay/sdk";
 import { Command as Command8 } from "commander";
 
+// src/lib/node-info.ts
+async function runNodeInfoCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  if (options.json) {
+    printJsonSuccess(nodeInfo);
+    return;
+  }
+  console.log("\u2705 Node info retrieved");
+  console.log(`  Version: ${nodeInfo.version}`);
+  console.log(`  Commit: ${nodeInfo.commit_hash}`);
+  console.log(`  Node ID: ${nodeInfo.node_id}`);
+  if (nodeInfo.features.length > 0) {
+    console.log("  Features:");
+    for (const feature of nodeInfo.features) {
+      console.log(`    - ${sanitizeForTerminal(feature)}`);
+    }
+  }
+  console.log(`  Name: ${sanitizeForTerminal(nodeInfo.node_name ?? "-")}`);
+  if (nodeInfo.addresses.length > 0) {
+    console.log("  Addresses:");
+    for (const address of nodeInfo.addresses) {
+      console.log(`    - ${sanitizeForTerminal(address)}`);
+    }
+  }
+  console.log(`  Chain Hash: ${nodeInfo.chain_hash}`);
+  console.log(`  Channels: ${BigInt(nodeInfo.channel_count)}`);
+  console.log(`  Pending Channels: ${BigInt(nodeInfo.pending_channel_count)}`);
+  console.log(`  Peers: ${BigInt(nodeInfo.peers_count)}`);
+  if (nodeInfo.udt_cfg_infos.length > 0) {
+    console.log("  UDT Configs:");
+    for (const udt of nodeInfo.udt_cfg_infos) {
+      console.log(`    - Name: ${sanitizeForTerminal(udt.name)}`);
+      console.log(`      Script: ${JSON.stringify(udt.script, null, 6)}`);
+      if (udt.auto_accept_amount) {
+        console.log(`      Auto Accept Amount: ${BigInt(udt.auto_accept_amount)}`);
+      }
+      if (udt.cell_deps.length > 0) {
+        console.log("      Cell Deps:");
+        for (const dep of udt.cell_deps) {
+          console.log(
+            `        - Cell Dep: ${dep.cell_dep ? JSON.stringify(dep.cell_dep) : "null"}`
+          );
+          console.log(`          Type ID: ${dep.type_id ? JSON.stringify(dep.type_id) : "null"}`);
+        }
+      }
+    }
+  }
+}
+
+// src/lib/node-network.ts
+import { shannonsToCkb as shannonsToCkb5, toHex as toHex4 } from "@fiber-pay/sdk";
+async function runNodeNetworkCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const [nodeInfo, localPeers, localChannels, graphNodes, graphChannels] = await Promise.all([
+    rpc.nodeInfo(),
+    rpc.listPeers(),
+    rpc.listChannels({ include_closed: false }),
+    rpc.graphNodes({}),
+    rpc.graphChannels({})
+  ]);
+  const graphNodesMap = /* @__PURE__ */ new Map();
+  for (const node of graphNodes.nodes) {
+    graphNodesMap.set(node.node_id, node);
+  }
+  const peerIdToNodeIdMap = /* @__PURE__ */ new Map();
+  for (const peer of localPeers.peers) {
+    peerIdToNodeIdMap.set(peer.peer_id, peer.pubkey);
+  }
+  const graphChannelsMap = /* @__PURE__ */ new Map();
+  for (const channel of graphChannels.channels) {
+    if (channel.channel_outpoint) {
+      const outpointKey = `${channel.channel_outpoint.tx_hash}:${channel.channel_outpoint.index}`;
+      graphChannelsMap.set(outpointKey, channel);
+    }
+  }
+  const enrichedPeers = localPeers.peers.map((peer) => ({
+    ...peer,
+    nodeInfo: graphNodesMap.get(peer.pubkey)
+  }));
+  const enrichedChannels = localChannels.channels.map((channel) => {
+    const nodeId = peerIdToNodeIdMap.get(channel.peer_id) || channel.peer_id;
+    const peerNodeInfo = graphNodesMap.get(nodeId);
+    let graphChannelInfo;
+    if (channel.channel_outpoint) {
+      const outpointKey = `${channel.channel_outpoint.tx_hash}:${channel.channel_outpoint.index}`;
+      graphChannelInfo = graphChannelsMap.get(outpointKey);
+    }
+    return {
+      ...channel,
+      peerNodeInfo,
+      graphChannelInfo
+    };
+  });
+  const activeChannels = enrichedChannels.filter((ch) => ch.state?.state_name === "CHANNEL_READY");
+  const totalChannelCapacityShannons = activeChannels.reduce((sum, ch) => {
+    const capacity = ch.graphChannelInfo?.capacity ? ch.graphChannelInfo.capacity : toHex4(BigInt(ch.local_balance) + BigInt(ch.remote_balance));
+    return sum + BigInt(capacity);
+  }, 0n);
+  const totalChannelCapacity = formatShannonsAsCkb(totalChannelCapacityShannons, 1);
+  const networkData = {
+    localNodeId: nodeInfo.node_id,
+    peers: enrichedPeers,
+    channels: enrichedChannels,
+    graphNodes: graphNodes.nodes,
+    graphChannels: graphChannels.channels,
+    summary: {
+      connectedPeers: enrichedPeers.length,
+      activeChannels: activeChannels.length,
+      totalChannelCapacity
+    }
+  };
+  if (options.json) {
+    printJsonSuccess(networkData);
+    return;
+  }
+  printNodeNetworkHuman(networkData);
+}
+function printNodeNetworkHuman(data) {
+  console.log("Node Network Overview");
+  console.log("=====================");
+  console.log("");
+  console.log(`Connected Peers: ${data.summary.connectedPeers}`);
+  console.log(`Active Channels: ${data.summary.activeChannels}`);
+  console.log(`Total Channel Capacity: ${data.summary.totalChannelCapacity} CKB`);
+  console.log("");
+  if (data.peers.length > 0) {
+    console.log("Peers:");
+    console.log("  PEER_ID                ALIAS                ADDRESS                    VERSION");
+    console.log(
+      "  --------------------------------------------------------------------------------"
+    );
+    for (const peer of data.peers) {
+      const peerId = truncateMiddle(peer.peer_id, 10, 8).padEnd(22, " ");
+      const alias = sanitizeForTerminal(peer.nodeInfo?.node_name || "(unnamed)").slice(0, 20).padEnd(20, " ");
+      const address = truncateMiddle(sanitizeForTerminal(peer.address), 15, 8).padEnd(25, " ");
+      const version = sanitizeForTerminal(peer.nodeInfo?.version || "?").slice(0, 8).padEnd(8, " ");
+      console.log(`  ${peerId} ${alias} ${address} ${version}`);
+    }
+    console.log("");
+  }
+  if (data.channels.length > 0) {
+    console.log("Channels:");
+    console.log(
+      "  CHANNEL_ID             PEER_ALIAS           STATE          LOCAL_BAL     REMOTE_BAL   CAPACITY"
+    );
+    console.log(
+      "  -----------------------------------------------------------------------------------------------"
+    );
+    for (const channel of data.channels) {
+      const channelId = truncateMiddle(channel.channel_id, 10, 8).padEnd(22, " ");
+      const peerAlias = sanitizeForTerminal(channel.peerNodeInfo?.node_name || "(unnamed)").slice(0, 18).padEnd(18, " ");
+      const state = (channel.state?.state_name || "UNKNOWN").slice(0, 13).padEnd(13, " ");
+      const localBal = shannonsToCkb5(channel.local_balance).toFixed(1).padStart(11, " ");
+      const remoteBal = shannonsToCkb5(channel.remote_balance).toFixed(1).padStart(11, " ");
+      const capacity = channel.graphChannelInfo?.capacity ? shannonsToCkb5(channel.graphChannelInfo.capacity).toFixed(1).padStart(8, " ") : shannonsToCkb5(toHex4(BigInt(channel.local_balance) + BigInt(channel.remote_balance))).toFixed(1).padStart(8, " ");
+      console.log(`  ${channelId} ${peerAlias} ${state} ${localBal} ${remoteBal} ${capacity}`);
+    }
+  }
+}
+
 // src/lib/node-start.ts
 import { spawn } from "child_process";
-import { appendFileSync, mkdirSync as mkdirSync2 } from "fs";
-import { join as join5 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { join as join7 } from "path";
 import {
   createKeyManager,
   ensureFiberBinary,
-  getDefaultBinaryPath,
   ProcessManager
 } from "@fiber-pay/node";
 import { startRuntimeService } from "@fiber-pay/runtime";
 
 // src/lib/bootnode.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
 import { parse as parseYaml } from "yaml";
 function extractBootnodeAddrs(configFilePath) {
-  if (!existsSync8(configFilePath)) return [];
+  if (!existsSync9(configFilePath)) return [];
   try {
     const content = readFileSync5(configFilePath, "utf-8");
     const doc = parseYaml(content);
@@ -2730,8 +3512,8 @@ async function autoConnectBootnodes(rpc, bootnodes) {
 }
 
 // src/lib/node-migration.ts
-import { dirname } from "path";
-import { BinaryManager, MigrationManager } from "@fiber-pay/node";
+import { dirname as dirname2 } from "path";
+import { BinaryManager as BinaryManager2, MigrationManager } from "@fiber-pay/node";
 
 // src/lib/migration-utils.ts
 function replaceRawMigrateHint(message) {
@@ -2754,8 +3536,8 @@ async function runMigrationGuard(opts) {
     return { checked: false, skippedReason: "store does not exist" };
   }
   const storePath = MigrationManager.resolveStorePath(dataDir);
-  const binaryDir = dirname(binaryPath);
-  const bm = new BinaryManager(binaryDir);
+  const binaryDir = dirname2(binaryPath);
+  const bm = new BinaryManager2(binaryDir);
   const migrateBinPath = bm.getMigrateBinaryPath();
   let migrationCheck;
   try {
@@ -2794,98 +3576,115 @@ async function runMigrationGuard(opts) {
   return { checked: true, migrationCheck };
 }
 
-// src/lib/node-runtime-daemon.ts
-import { spawnSync } from "child_process";
-import { existsSync as existsSync9 } from "fs";
-function getCustomBinaryState(binaryPath) {
-  const exists = existsSync9(binaryPath);
-  if (!exists) {
-    return { path: binaryPath, ready: false, version: "unknown" };
+// src/lib/runtime-port.ts
+import { spawnSync as spawnSync2 } from "child_process";
+function parsePortFromListen(listen) {
+  const value = listen.trim();
+  if (!value) {
+    return void 0;
   }
-  try {
-    const result = spawnSync(binaryPath, ["--version"], { encoding: "utf-8" });
-    if (result.status !== 0) {
-      return { path: binaryPath, ready: false, version: "unknown" };
-    }
-    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
-    const firstLine = output.split("\n").find((line) => line.trim().length > 0) ?? "unknown";
-    return { path: binaryPath, ready: true, version: firstLine.trim() };
-  } catch {
-    return { path: binaryPath, ready: false, version: "unknown" };
+  const lastColon = value.lastIndexOf(":");
+  if (lastColon < 0 || lastColon === value.length - 1) {
+    return void 0;
   }
+  const port = Number(value.slice(lastColon + 1));
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    return void 0;
+  }
+  return port;
 }
-function getBinaryVersion(binaryPath) {
-  try {
-    const result = spawnSync(binaryPath, ["--version"], { encoding: "utf-8" });
-    if (result.status !== 0) {
-      return "unknown";
+function extractFirstPidFromLsofOutput(output) {
+  for (const line of output.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("p") || trimmed.length < 2) {
+      continue;
     }
-    const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
-    if (!output) {
-      return "unknown";
+    const pid = Number(trimmed.slice(1));
+    if (Number.isInteger(pid) && pid > 0) {
+      return pid;
     }
-    const firstLine = output.split("\n").find((line) => line.trim().length > 0);
-    return firstLine?.trim() ?? "unknown";
-  } catch {
-    return "unknown";
   }
+  return void 0;
 }
-function getCliEntrypoint() {
-  const entrypoint = process.argv[1];
-  if (!entrypoint) {
-    throw new Error("Unable to resolve CLI entrypoint path");
+function readProcessCommand(pid) {
+  const result = spawnSync2("ps", ["-p", String(pid), "-o", "command="], {
+    encoding: "utf-8"
+  });
+  if (result.error || result.status !== 0) {
+    return void 0;
   }
-  return entrypoint;
+  const command = (result.stdout ?? "").trim();
+  return command.length > 0 ? command : void 0;
 }
-function startRuntimeDaemonFromNode(params) {
-  const cliEntrypoint = getCliEntrypoint();
-  const result = spawnSync(
-    process.execPath,
-    [
-      cliEntrypoint,
-      "--data-dir",
-      params.dataDir,
-      "--rpc-url",
-      params.rpcUrl,
-      "runtime",
-      "start",
-      "--daemon",
-      "--fiber-rpc-url",
-      params.rpcUrl,
-      "--proxy-listen",
-      params.proxyListen,
-      "--state-file",
-      params.stateFilePath,
-      "--alert-log-file",
-      params.alertLogFile,
-      "--json"
-    ],
-    { encoding: "utf-8" }
-  );
-  if (result.status === 0) {
-    return { ok: true };
+function findListeningProcessByPort(listen) {
+  const port = parsePortFromListen(listen);
+  if (!port) {
+    return void 0;
   }
-  const stderr = (result.stderr ?? "").trim();
-  const stdout = (result.stdout ?? "").trim();
-  const details = stderr || stdout || `exit code ${result.status ?? "unknown"}`;
-  return { ok: false, message: details };
+  const result = spawnSync2("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-Fp"], {
+    encoding: "utf-8"
+  });
+  if (result.error || result.status !== 0) {
+    return void 0;
+  }
+  const pid = extractFirstPidFromLsofOutput(result.stdout ?? "");
+  if (!pid) {
+    return void 0;
+  }
+  return {
+    pid,
+    command: readProcessCommand(pid)
+  };
 }
-function stopRuntimeDaemonFromNode(params) {
-  const cliEntrypoint = getCliEntrypoint();
-  spawnSync(
-    process.execPath,
-    [
-      cliEntrypoint,
-      "--data-dir",
-      params.dataDir,
-      "--rpc-url",
-      params.rpcUrl,
-      "runtime",
-      "stop",
-      "--json"
-    ],
-    { encoding: "utf-8" }
-  );
+function isFiberRuntimeCommand(command) {
+  if (!command) {
+    return false;
+  }
+  const normalized = command.toLowerCase();
+  const hasFiberIdentifier = normalized.includes("fiber-pay") || normalized.includes("@fiber-pay/cli") || normalized.includes("/packages/cli/dist/cli.js") || normalized.includes("\\packages\\cli\\dist\\cli.js") || normalized.includes("/dist/cli.js") || normalized.includes("\\dist\\cli.js");
+  if (!hasFiberIdentifier) {
+    return false;
+  }
+  return normalized.includes("runtime") && normalized.includes("start");
+}
+async function terminateProcess(pid, timeoutMs = 5e3) {
+  if (!isProcessRunning(pid)) {
+    return true;
+  }
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch (error) {
+    if (error.code === "ESRCH") {
+      return true;
+    }
+    return false;
+  }
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (!isProcessRunning(pid)) {
+      return true;
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 100));
+  }
+  if (!isProcessRunning(pid)) {
+    return true;
+  }
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch (error) {
+    if (error.code === "ESRCH") {
+      return true;
+    }
+    return false;
+  }
+  const killDeadline = Date.now() + 1e3;
+  while (Date.now() < killDeadline) {
+    if (!isProcessRunning(pid)) {
+      return true;
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 50));
+  }
+  return !isProcessRunning(pid);
 }
 
 // src/lib/node-start.ts
@@ -2997,19 +3796,22 @@ async function runNodeStartCommand(config, options) {
     options.runtimeProxyListen ?? config.runtimeProxyListen ?? "127.0.0.1:8229"
   );
   const proxyListenSource = options.runtimeProxyListen ? "cli" : config.runtimeProxyListen ? "profile" : "default";
-  const runtimeStateFilePath = join5(config.dataDir, "runtime-state.json");
-  const logsDir = join5(config.dataDir, "logs");
-  const fnnStdoutLogPath = join5(logsDir, "fnn.stdout.log");
-  const fnnStderrLogPath = join5(logsDir, "fnn.stderr.log");
-  const runtimeAlertLogPath = join5(logsDir, "runtime.alerts.jsonl");
-  mkdirSync2(logsDir, { recursive: true });
-  const binaryPath = config.binaryPath || getDefaultBinaryPath();
-  await ensureFiberBinary();
+  const runtimeStateFilePath = join7(config.dataDir, "runtime-state.json");
+  const logsBaseDir = join7(config.dataDir, "logs");
+  mkdirSync3(logsBaseDir, { recursive: true });
+  resolveLogDirForDate(config.dataDir);
+  const resolvedBinary = resolveBinaryPath(config);
+  const binaryPath = resolvedBinary.binaryPath;
+  if (resolvedBinary.source === "profile-managed") {
+    const installDir = getBinaryManagerInstallDirOrThrow(resolvedBinary);
+    await ensureFiberBinary({ installDir });
+  }
   const binaryVersion = getBinaryVersion(binaryPath);
   const configFilePath = ensureNodeConfigFile(config.dataDir, config.network);
   emitStage("binary_resolved", "ok", {
     binaryPath,
     binaryVersion,
+    binarySource: resolvedBinary.source,
     configFilePath
   });
   if (!json) {
@@ -3070,11 +3872,11 @@ async function runNodeStartCommand(config, options) {
     removePidFile(config.dataDir);
   });
   processManager.on("stdout", (text) => {
-    appendFileSync(fnnStdoutLogPath, text, "utf-8");
+    appendToTodayLog(config.dataDir, "fnn.stdout.log", text);
     emitFnnLog("stdout", text);
   });
   processManager.on("stderr", (text) => {
-    appendFileSync(fnnStderrLogPath, text, "utf-8");
+    appendToTodayLog(config.dataDir, "fnn.stderr.log", text);
     emitFnnLog("stderr", text);
   });
   await processManager.start();
@@ -3119,13 +3921,38 @@ async function runNodeStartCommand(config, options) {
     process.exit(1);
   }
   try {
+    const runtimePortProcess = findListeningProcessByPort(runtimeProxyListen);
+    if (runtimePortProcess) {
+      if (isFiberRuntimeCommand(runtimePortProcess.command)) {
+        const terminated = await terminateProcess(runtimePortProcess.pid);
+        if (!terminated) {
+          throw new Error(
+            `Runtime proxy ${runtimeProxyListen} is occupied by stale fiber-pay runtime PID ${runtimePortProcess.pid}, but termination failed`
+          );
+        }
+        removeRuntimeFiles(config.dataDir);
+        emitStage("runtime_preflight", "ok", {
+          proxyListen: runtimeProxyListen,
+          cleanedStaleProcessPid: runtimePortProcess.pid
+        });
+      } else if (runtimePortProcess.command) {
+        const details = runtimePortProcess.command ? `PID ${runtimePortProcess.pid} (${runtimePortProcess.command})` : `PID ${runtimePortProcess.pid}`;
+        throw new Error(
+          `Runtime proxy ${runtimeProxyListen} is already in use by non-fiber-pay process: ${details}`
+        );
+      } else {
+        throw new Error(
+          `Runtime proxy ${runtimeProxyListen} is already in use by process PID ${runtimePortProcess.pid}. Unable to determine command owner; inspect this PID manually before retrying.`
+        );
+      }
+    }
     if (runtimeDaemon) {
       const daemonStart = startRuntimeDaemonFromNode({
         dataDir: config.dataDir,
         rpcUrl: config.rpcUrl,
         proxyListen: runtimeProxyListen,
         stateFilePath: runtimeStateFilePath,
-        alertLogFile: runtimeAlertLogPath
+        alertLogsBaseDir: logsBaseDir
       });
       if (!daemonStart.ok) {
         throw new Error(daemonStart.message);
@@ -3140,23 +3967,25 @@ async function runNodeStartCommand(config, options) {
         storage: {
           stateFilePath: runtimeStateFilePath
         },
-        alerts: [{ type: "stdout" }, { type: "file", path: runtimeAlertLogPath }],
+        alerts: [{ type: "stdout" }, { type: "daily-file", baseLogsDir: logsBaseDir }],
         jobs: {
           enabled: true,
-          dbPath: join5(config.dataDir, "runtime-jobs.db")
+          dbPath: join7(config.dataDir, "runtime-jobs.db")
         }
       });
       const runtimeStatus = runtime.service.getStatus();
       writeRuntimePid(config.dataDir, process.pid);
+      const todayLogDir = resolveLogDirForDate(config.dataDir);
       writeRuntimeMeta(config.dataDir, {
         pid: process.pid,
         startedAt: runtimeStatus.startedAt,
         fiberRpcUrl: runtimeStatus.targetUrl,
         proxyListen: runtimeStatus.proxyListen,
         stateFilePath: runtimeStateFilePath,
-        alertLogFilePath: runtimeAlertLogPath,
-        fnnStdoutLogPath,
-        fnnStderrLogPath,
+        alertLogFilePath: join7(todayLogDir, "runtime.alerts.jsonl"),
+        fnnStdoutLogPath: join7(todayLogDir, "fnn.stdout.log"),
+        fnnStderrLogPath: join7(todayLogDir, "fnn.stderr.log"),
+        logsBaseDir,
         daemon: false
       });
     }
@@ -3226,7 +4055,7 @@ async function runNodeStartCommand(config, options) {
     process.exit(1);
   }
   emitStage("rpc_ready", "ok", { rpcUrl: config.rpcUrl });
-  const bootnodes = nodeConfig.configFilePath ? extractBootnodeAddrs(nodeConfig.configFilePath) : extractBootnodeAddrs(join5(config.dataDir, "config.yml"));
+  const bootnodes = nodeConfig.configFilePath ? extractBootnodeAddrs(nodeConfig.configFilePath) : extractBootnodeAddrs(join7(config.dataDir, "config.yml"));
   if (bootnodes.length > 0) {
     await autoConnectBootnodes(rpc, bootnodes);
   }
@@ -3267,9 +4096,8 @@ async function runNodeStartCommand(config, options) {
       proxyUrl: `http://${runtimeProxyListen}`,
       proxyListenSource,
       logs: {
-        fnnStdout: fnnStdoutLogPath,
-        fnnStderr: fnnStderrLogPath,
-        runtimeAlerts: runtimeAlertLogPath
+        baseDir: logsBaseDir,
+        todayDir: resolveLogDirForDate(config.dataDir)
       }
     });
   } else {
@@ -3279,7 +4107,7 @@ async function runNodeStartCommand(config, options) {
       `   Runtime proxy: http://${runtimeProxyListen} (browser-safe endpoint + monitoring)`
     );
     console.log(`   Runtime mode:  ${runtimeDaemon ? "daemon" : "embedded"}`);
-    console.log(`   Log files:     ${logsDir}`);
+    console.log(`   Log files:     ${logsBaseDir}`);
     console.log("   Press Ctrl+C to stop.");
   }
   let shutdownRequested = false;
@@ -3347,8 +4175,6 @@ async function runNodeStartCommand(config, options) {
 
 // src/lib/node-status.ts
 import { existsSync as existsSync10 } from "fs";
-import { join as join6 } from "path";
-import { getFiberBinaryInfo as getFiberBinaryInfo2 } from "@fiber-pay/node";
 import {
   buildMultiaddrFromNodeId,
   buildMultiaddrFromRpcUrl,
@@ -3515,24 +4341,30 @@ async function runNodeStatusCommand(config, options) {
   const json = Boolean(options.json);
   const pid = readPidFile(config.dataDir);
   const resolvedRpc = resolveRpcEndpoint(config);
-  const managedBinaryPath = join6(config.dataDir, "bin", "fnn");
-  const binaryInfo = config.binaryPath ? getCustomBinaryState(config.binaryPath) : await getFiberBinaryInfo2(join6(config.dataDir, "bin"));
+  const { resolvedBinary, info: binaryInfo } = await getBinaryDetails(config);
   const configExists = existsSync10(config.configPath);
   const nodeRunning = Boolean(pid && isProcessRunning(pid));
   let rpcResponsive = false;
   let nodeId = null;
+  let nodeName = null;
+  let addresses = [];
+  let chainHash = null;
+  let version = null;
   let peerId = null;
+  let peersCount = 0;
   let peerIdError = null;
   let multiaddr = null;
   let multiaddrError = null;
   let multiaddrInferred = false;
   let channelsTotal = 0;
   let channelsReady = 0;
+  let pendingChannelCount = 0;
   let canSend = false;
   let canReceive = false;
   let localCkb = 0;
   let remoteCkb = 0;
   let fundingAddress = null;
+  let fundingLockScript = null;
   let fundingCkb = 0;
   let fundingBalanceError = null;
   if (nodeRunning) {
@@ -3542,6 +4374,11 @@ async function runNodeStatusCommand(config, options) {
       const channels = await rpc.listChannels({ include_closed: false });
       rpcResponsive = true;
       nodeId = nodeInfo.node_id;
+      nodeName = nodeInfo.node_name;
+      addresses = nodeInfo.addresses;
+      chainHash = nodeInfo.chain_hash;
+      version = nodeInfo.version;
+      peersCount = parseInt(nodeInfo.peers_count, 16);
       try {
         peerId = await nodeIdToPeerId(nodeInfo.node_id);
       } catch (error) {
@@ -3568,18 +4405,17 @@ async function runNodeStatusCommand(config, options) {
         (channel) => channel.state?.state_name === ChannelState2.ChannelReady
       );
       channelsReady = readyChannels.length;
+      pendingChannelCount = Math.max(channelsTotal - channelsReady, 0);
       const liquidity = summarizeChannelLiquidity(readyChannels);
       canSend = liquidity.canSend;
       canReceive = liquidity.canReceive;
       localCkb = liquidity.localCkb;
       remoteCkb = liquidity.remoteCkb;
       fundingAddress = scriptToAddress(nodeInfo.default_funding_lock_script, config.network);
+      fundingLockScript = nodeInfo.default_funding_lock_script;
       if (config.ckbRpcUrl) {
         try {
-          const fundingBalance = await getLockBalanceShannons(
-            config.ckbRpcUrl,
-            nodeInfo.default_funding_lock_script
-          );
+          const fundingBalance = await getLockBalanceShannons(config.ckbRpcUrl, fundingLockScript);
           fundingCkb = Number(fundingBalance) / 1e8;
         } catch (error) {
           fundingBalanceError = error instanceof Error ? error.message : "Failed to query CKB balance for funding address";
@@ -3610,18 +4446,25 @@ async function runNodeStatusCommand(config, options) {
     rpcTarget: resolvedRpc.target,
     resolvedRpcUrl: resolvedRpc.url,
     nodeId,
+    nodeName,
+    addresses,
+    chainHash,
+    version,
     peerId,
+    peersCount,
     peerIdError,
     multiaddr,
     multiaddrError,
     multiaddrInferred,
+    fundingLockScript,
     checks: {
       binary: {
         path: binaryInfo.path,
         ready: binaryInfo.ready,
         version: binaryInfo.version,
-        source: config.binaryPath ? "env-binary-path" : "managed-binary-dir",
-        managedPath: managedBinaryPath
+        source: resolvedBinary.source,
+        managedPath: resolvedBinary.managedPath,
+        resolvedPath: resolvedBinary.binaryPath
       },
       config: {
         path: config.configPath,
@@ -3639,6 +4482,7 @@ async function runNodeStatusCommand(config, options) {
       channels: {
         total: channelsTotal,
         ready: channelsReady,
+        pending: pendingChannelCount,
         canSend,
         canReceive
       }
@@ -3665,6 +4509,15 @@ async function runNodeStatusCommand(config, options) {
     console.log(`\u2705 Node is running (PID: ${output.pid})`);
     if (output.rpcResponsive) {
       console.log(`   Node ID: ${String(output.nodeId)}`);
+      if (output.nodeName) {
+        console.log(`   Name: ${sanitizeForTerminal(output.nodeName)}`);
+      }
+      if (output.version) {
+        console.log(`   Version: ${sanitizeForTerminal(output.version)}`);
+      }
+      if (output.chainHash) {
+        console.log(`   Chain Hash: ${String(output.chainHash)}`);
+      }
       if (output.peerId) {
         console.log(`   Peer ID: ${String(output.peerId)}`);
       } else if (output.peerIdError) {
@@ -3680,6 +4533,12 @@ async function runNodeStatusCommand(config, options) {
       } else {
         console.log("   Multiaddr: unavailable");
       }
+      if (output.addresses.length > 0) {
+        console.log("   Addresses:");
+        for (const address of output.addresses) {
+          console.log(`     - ${sanitizeForTerminal(address)}`);
+        }
+      }
     } else {
       console.log("   \u26A0\uFE0F  RPC not responding");
     }
@@ -3691,11 +4550,17 @@ async function runNodeStatusCommand(config, options) {
   console.log("");
   console.log("Diagnostics");
   console.log(`  Binary:        ${output.checks.binary.ready ? "ready" : "missing"}`);
+  console.log(`  Binary Path:   ${output.checks.binary.resolvedPath}`);
   console.log(`  Config:        ${output.checks.config.exists ? "present" : "missing"}`);
   console.log(`  RPC:           ${output.checks.node.rpcReachable ? "reachable" : "unreachable"}`);
   console.log(
-    `  Channels:      ${output.checks.channels.ready}/${output.checks.channels.total} ready/total`
+    `  Channels:      ${output.checks.channels.ready}/${output.checks.channels.pending}/${output.checks.channels.total} ready/pending/total`
   );
+  if (output.rpcResponsive) {
+    console.log(`  Peers:         ${output.peersCount}`);
+  } else {
+    console.log("  Peers:         unavailable");
+  }
   console.log(`  Can Send:      ${output.checks.channels.canSend ? "yes" : "no"}`);
   console.log(`  Can Receive:   ${output.checks.channels.canReceive ? "yes" : "no"}`);
   console.log(`  Recommendation:${output.recommendation}`);
@@ -3858,11 +4723,28 @@ async function runNodeStopCommand(config, options) {
 }
 
 // src/lib/node-upgrade.ts
-import { BinaryManager as BinaryManager2, MigrationManager as MigrationManager2 } from "@fiber-pay/node";
+import { BinaryManager as BinaryManager3, MigrationManager as MigrationManager2 } from "@fiber-pay/node";
 async function runNodeUpgradeCommand(config, options) {
   const json = Boolean(options.json);
-  const installDir = `${config.dataDir}/bin`;
-  const binaryManager = new BinaryManager2(installDir);
+  const resolvedBinary = resolveBinaryPath(config);
+  let installDir;
+  try {
+    installDir = getBinaryManagerInstallDirOrThrow(resolvedBinary);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (json) {
+      printJsonError({
+        code: "BINARY_PATH_INCOMPATIBLE",
+        message,
+        recoverable: true,
+        suggestion: "Use `fiber-pay config profile unset binaryPath` or set binaryPath to a standard fnn filename in the target directory."
+      });
+    } else {
+      console.error(`\u274C ${message}`);
+    }
+    process.exit(1);
+  }
+  const binaryManager = new BinaryManager3(installDir);
   const pid = readPidFile(config.dataDir);
   if (pid && isProcessRunning(pid)) {
     const msg = "The Fiber node is currently running. Stop it before upgrading.";
@@ -4131,32 +5013,15 @@ function createNodeCommand(config) {
   node.command("status").option("--json").action(async (options) => {
     await runNodeStatusCommand(config, options);
   });
+  node.command("network").description("Display comprehensive network topology and connections").option("--json").action(async (options) => {
+    await runNodeNetworkCommand(config, options);
+  });
+  node.command("info").description("Display information about the running node").option("--json").action(async (options) => {
+    await runNodeInfoCommand(config, options);
+  });
   node.command("ready").description("Agent-oriented readiness summary for automation").option("--json").action(async (options) => {
     await runNodeReadyCommand(config, options);
   });
-  node.command("info").option("--json").action(async (options) => {
-    const rpc = await createReadyRpcClient(config);
-    const nodeInfo = await rpc.nodeInfo();
-    const fundingAddress = scriptToAddress2(nodeInfo.default_funding_lock_script, config.network);
-    const peerId = await nodeIdToPeerId2(nodeInfo.node_id);
-    const output = {
-      nodeId: nodeInfo.node_id,
-      peerId,
-      addresses: nodeInfo.addresses,
-      chainHash: nodeInfo.chain_hash,
-      fundingAddress,
-      fundingLockScript: nodeInfo.default_funding_lock_script,
-      version: nodeInfo.version,
-      channelCount: parseInt(nodeInfo.channel_count, 16),
-      pendingChannelCount: parseInt(nodeInfo.pending_channel_count, 16),
-      peersCount: parseInt(nodeInfo.peers_count, 16)
-    };
-    if (options.json) {
-      printJsonSuccess(output);
-    } else {
-      printNodeInfoHuman(output);
-    }
-  });
   node.command("upgrade").description("Upgrade the Fiber node binary and migrate the database if needed").option("--version <version>", "Target Fiber version (default: latest)").option("--no-backup", "Skip creating a store backup before migration").option("--check-only", "Only check if migration is needed, do not migrate").option(
     "--force-migrate",
     "Force migration attempt even when compatibility check reports incompatible data"
@@ -4167,7 +5032,7 @@ function createNodeCommand(config) {
 }
 
 // src/commands/payment.ts
-import { ckbToShannons as ckbToShannons3, shannonsToCkb as shannonsToCkb4 } from "@fiber-pay/sdk";
+import { ckbToShannons as ckbToShannons4, shannonsToCkb as shannonsToCkb6 } from "@fiber-pay/sdk";
 import { Command as Command9 } from "commander";
 function createPaymentCommand(config) {
   const payment = new Command9("payment").description("Payment lifecycle and status commands");
@@ -4209,9 +5074,9 @@ function createPaymentCommand(config) {
     const paymentParams = {
       invoice,
       target_pubkey: recipientNodeId,
-      amount: amountCkb ? ckbToShannons3(amountCkb) : void 0,
+      amount: amountCkb ? ckbToShannons4(amountCkb) : void 0,
       keysend: recipientNodeId ? true : void 0,
-      max_fee_amount: maxFeeCkb ? ckbToShannons3(maxFeeCkb) : void 0
+      max_fee_amount: maxFeeCkb ? ckbToShannons4(maxFeeCkb) : void 0
     };
     const endpoint = resolveRpcEndpoint(config);
     if (endpoint.target === "runtime-proxy") {
@@ -4253,7 +5118,7 @@ function createPaymentCommand(config) {
     const payload = {
       paymentHash: result.payment_hash,
       status: result.status === "Success" ? "success" : result.status === "Failed" ? "failed" : "pending",
-      feeCkb: shannonsToCkb4(result.fee),
+      feeCkb: shannonsToCkb6(result.fee),
       failureReason: result.failed_error
     };
     if (json) {
@@ -4268,6 +5133,7 @@ function createPaymentCommand(config) {
       }
     }
   });
+  registerPaymentRebalanceCommand(payment, config);
   payment.command("get").argument("<paymentHash>").option("--json").action(async (paymentHash, options) => {
     const rpc = await createReadyRpcClient(config);
     const result = await rpc.getPayment({ payment_hash: paymentHash });
@@ -4416,7 +5282,7 @@ function createPaymentCommand(config) {
       process.exit(1);
     }
     const hopsInfo = pubkeys.map((pubkey) => ({ pubkey }));
-    const amount = options.amount ? ckbToShannons3(parseFloat(options.amount)) : void 0;
+    const amount = options.amount ? ckbToShannons4(parseFloat(options.amount)) : void 0;
     const result = await rpc.buildRouter({
       hops_info: hopsInfo,
       amount
@@ -4432,7 +5298,7 @@ function createPaymentCommand(config) {
         console.log(
           `    Outpoint:   ${hop.channel_outpoint.tx_hash}:${hop.channel_outpoint.index}`
         );
-        console.log(`    Amount:     ${shannonsToCkb4(hop.amount_received)} CKB`);
+        console.log(`    Amount:     ${shannonsToCkb6(hop.amount_received)} CKB`);
         console.log(`    Expiry:     ${hop.incoming_tlc_expiry}`);
       }
     }
@@ -4440,7 +5306,7 @@ function createPaymentCommand(config) {
   payment.command("send-route").description("Send a payment using a pre-built route from `payment route`").requiredOption(
     "--router <json>",
     "JSON array of router hops (output of `payment route --json`)"
-  ).option("--invoice <invoice>", "Invoice to pay").option("--payment-hash <hash>", "Payment hash (for keysend)").option("--keysend", "Keysend mode").option("--dry-run", "Simulate\u2014do not actually send").option("--json").action(async (options) => {
+  ).option("--invoice <invoice>", "Invoice to pay").option("--payment-hash <hash>", "Payment hash (for keysend)").option("--keysend", "Keysend mode").option("--allow-self-payment", "Allow self-payment for circular route rebalancing").option("--dry-run", "Simulate\u2014do not actually send").option("--json").action(async (options) => {
     const rpc = await createReadyRpcClient(config);
     const json = Boolean(options.json);
     let router;
@@ -4465,12 +5331,13 @@ function createPaymentCommand(config) {
       invoice: options.invoice,
       payment_hash: options.paymentHash,
       keysend: options.keysend ? true : void 0,
+      allow_self_payment: options.allowSelfPayment ? true : void 0,
       dry_run: options.dryRun ? true : void 0
     });
     const payload = {
       paymentHash: result.payment_hash,
       status: result.status === "Success" ? "success" : result.status === "Failed" ? "failed" : "pending",
-      feeCkb: shannonsToCkb4(result.fee),
+      feeCkb: shannonsToCkb6(result.fee),
       failureReason: result.failed_error,
       dryRun: Boolean(options.dryRun)
     };
@@ -4494,7 +5361,7 @@ function getJobPaymentHash(job) {
 }
 function getJobFeeCkb(job) {
   const result = job.result;
-  return result?.fee ? shannonsToCkb4(result.fee) : 0;
+  return result?.fee ? shannonsToCkb6(result.fee) : 0;
 }
 function getJobFailure(job) {
   const result = job.result;
@@ -4566,7 +5433,7 @@ function createPeerCommand(config) {
 
 // src/commands/runtime.ts
 import { spawn as spawn2 } from "child_process";
-import { resolve } from "path";
+import { join as join8, resolve } from "path";
 import {
   alertPriorityOrder,
   formatRuntimeAlert as formatRuntimeAlert2,
@@ -4640,15 +5507,22 @@ function shouldPrintAlert(alert, filter) {
   }
   return true;
 }
+function resolveRuntimeRecoveryListen(config) {
+  const meta = readRuntimeMeta(config.dataDir);
+  return meta?.proxyListen ?? config.runtimeProxyListen ?? "127.0.0.1:8229";
+}
 function createRuntimeCommand(config) {
   const runtime = new Command11("runtime").description("Polling monitor and alert runtime service");
-  runtime.command("start").description("Start runtime monitor service in foreground").option("--daemon", "Start runtime monitor in detached background mode").option("--fiber-rpc-url <url>", "Target fiber rpc URL (defaults to --rpc-url/global config)").option("--proxy-listen <host:port>", "Monitor proxy listen address").option("--channel-poll-ms <ms>", "Channel polling interval in milliseconds").option("--invoice-poll-ms <ms>", "Invoice polling interval in milliseconds").option("--payment-poll-ms <ms>", "Payment polling interval in milliseconds").option("--peer-poll-ms <ms>", "Peer polling interval in milliseconds").option("--health-poll-ms <ms>", "RPC health polling interval in milliseconds").option("--include-closed <bool>", "Monitor closed channels (true|false)").option("--completed-ttl-seconds <seconds>", "TTL for completed invoices/payments in tracker").option("--state-file <path>", "State file path for snapshots and history").option("--alert-log-file <path>", "Path to runtime alert JSONL log file").option("--flush-ms <ms>", "State flush interval in milliseconds").option("--webhook <url>", "Webhook URL to receive alert POST payloads").option("--websocket <host:port>", "WebSocket alert broadcast listen address").option(
+  runtime.command("start").description("Start runtime monitor service in foreground").option("--daemon", "Start runtime monitor in detached background mode").option("--fiber-rpc-url <url>", "Target fiber rpc URL (defaults to --rpc-url/global config)").option("--proxy-listen <host:port>", "Monitor proxy listen address").option("--channel-poll-ms <ms>", "Channel polling interval in milliseconds").option("--invoice-poll-ms <ms>", "Invoice polling interval in milliseconds").option("--payment-poll-ms <ms>", "Payment polling interval in milliseconds").option("--peer-poll-ms <ms>", "Peer polling interval in milliseconds").option("--health-poll-ms <ms>", "RPC health polling interval in milliseconds").option("--include-closed <bool>", "Monitor closed channels (true|false)").option("--completed-ttl-seconds <seconds>", "TTL for completed invoices/payments in tracker").option("--state-file <path>", "State file path for snapshots and history").option("--alert-log-file <path>", "Path to runtime alert JSONL log file (legacy static path)").option("--alert-logs-base-dir <dir>", "Base logs directory for daily-rotated alert files").option("--flush-ms <ms>", "State flush interval in milliseconds").option("--webhook <url>", "Webhook URL to receive alert POST payloads").option("--websocket <host:port>", "WebSocket alert broadcast listen address").option(
     "--log-min-priority <priority>",
     "Minimum runtime log priority (critical|high|medium|low)"
   ).option("--log-type <types>", "Comma-separated runtime alert types to print").option("--json").action(async (options) => {
     const asJson = Boolean(options.json);
     const daemon = Boolean(options.daemon);
     const isRuntimeChild = process.env.FIBER_RUNTIME_CHILD === "1";
+    const runtimeListen = String(
+      options.proxyListen ?? config.runtimeProxyListen ?? "127.0.0.1:8229"
+    );
     try {
       const existingPid = readRuntimePid(config.dataDir);
       if (existingPid && isProcessRunning(existingPid) && (!isRuntimeChild || existingPid !== process.pid)) {
@@ -4668,6 +5542,32 @@ function createRuntimeCommand(config) {
       if (existingPid && !isProcessRunning(existingPid)) {
         removeRuntimeFiles(config.dataDir);
       }
+      const discovered = findListeningProcessByPort(runtimeListen);
+      if (discovered && (!existingPid || discovered.pid !== existingPid)) {
+        if (isFiberRuntimeCommand(discovered.command)) {
+          const terminated = await terminateProcess(discovered.pid);
+          if (!terminated) {
+            throw new Error(
+              `Runtime port ${runtimeListen} is occupied by stale fiber-pay runtime PID ${discovered.pid} but termination failed.`
+            );
+          }
+          removeRuntimeFiles(config.dataDir);
+          if (!asJson) {
+            console.log(
+              `Recovered stale runtime process on ${runtimeListen} (PID: ${discovered.pid}).`
+            );
+          }
+        } else if (discovered.command) {
+          const details = discovered.command ? `PID ${discovered.pid} (${discovered.command})` : `PID ${discovered.pid}`;
+          throw new Error(
+            `Runtime proxy listen ${runtimeListen} is already in use by non-fiber-pay process: ${details}`
+          );
+        } else {
+          throw new Error(
+            `Runtime proxy listen ${runtimeListen} is already in use by process PID ${discovered.pid}. Unable to determine the owning command; inspect this PID manually before retrying.`
+          );
+        }
+      }
       if (daemon && !isRuntimeChild) {
         const childArgv = process.argv.filter((arg) => arg !== "--daemon");
         const child = spawn2(process.execPath, childArgv.slice(1), {
@@ -4710,7 +5610,7 @@ function createRuntimeCommand(config) {
         ),
         proxy: {
           enabled: true,
-          listen: String(options.proxyListen ?? config.runtimeProxyListen ?? "127.0.0.1:8229")
+          listen: runtimeListen
         },
         storage: {
           stateFilePath: options.stateFile ? resolve(String(options.stateFile)) : resolve(config.dataDir, "runtime-state.json"),
@@ -4721,9 +5621,21 @@ function createRuntimeCommand(config) {
           dbPath: resolve(config.dataDir, "runtime-jobs.db")
         }
       };
-      const alertLogFile = options.alertLogFile ? resolve(String(options.alertLogFile)) : resolve(config.dataDir, "logs", "runtime.alerts.jsonl");
+      let alertLogsBaseDir;
+      let alertLogFile;
+      if (options.alertLogsBaseDir) {
+        alertLogsBaseDir = resolve(String(options.alertLogsBaseDir));
+      } else if (options.alertLogFile) {
+        alertLogFile = resolve(String(options.alertLogFile));
+      } else {
+        alertLogsBaseDir = resolve(config.dataDir, "logs");
+      }
       const alerts = [{ type: "stdout" }];
-      alerts.push({ type: "file", path: alertLogFile });
+      if (alertLogsBaseDir) {
+        alerts.push({ type: "daily-file", baseLogsDir: alertLogsBaseDir });
+      } else if (alertLogFile) {
+        alerts.push({ type: "file", path: alertLogFile });
+      }
       if (options.webhook) {
         alerts.push({ type: "webhook", url: String(options.webhook) });
       }
@@ -4745,6 +5657,12 @@ function createRuntimeCommand(config) {
       }
       const runtime2 = await startRuntimeService2(runtimeConfig);
       const status = runtime2.service.getStatus();
+      const logsBaseDir = alertLogsBaseDir ?? resolve(config.dataDir, "logs");
+      const todayLogDir = resolveLogDirForDateWithOptions(config.dataDir, void 0, {
+        logsBaseDir,
+        ensureExists: false
+      });
+      const effectiveAlertLogPath = alertLogsBaseDir ? join8(todayLogDir, "runtime.alerts.jsonl") : alertLogFile ?? join8(todayLogDir, "runtime.alerts.jsonl");
       writeRuntimePid(config.dataDir, process.pid);
       writeRuntimeMeta(config.dataDir, {
         pid: process.pid,
@@ -4752,7 +5670,10 @@ function createRuntimeCommand(config) {
         fiberRpcUrl: status.targetUrl,
         proxyListen: status.proxyListen,
         stateFilePath: runtimeConfig.storage?.stateFilePath,
-        alertLogFilePath: alertLogFile,
+        alertLogFilePath: effectiveAlertLogPath,
+        fnnStdoutLogPath: join8(todayLogDir, "fnn.stdout.log"),
+        fnnStderrLogPath: join8(todayLogDir, "fnn.stderr.log"),
+        logsBaseDir,
         daemon: daemon || isRuntimeChild
       });
       runtime2.service.on("alert", (alert) => {
@@ -4771,14 +5692,16 @@ function createRuntimeCommand(config) {
           fiberRpcUrl: status.targetUrl,
           proxyListen: status.proxyListen,
           stateFilePath: runtimeConfig.storage?.stateFilePath,
-          alertLogFile
+          alertLogFile: effectiveAlertLogPath,
+          logsBaseDir
         });
         printJsonEvent("runtime_started", status);
       } else {
         console.log(`Fiber RPC:    ${status.targetUrl}`);
         console.log(`Proxy listen: ${status.proxyListen}`);
         console.log(`State file:   ${runtimeConfig.storage?.stateFilePath}`);
-        console.log(`Alert log:    ${alertLogFile}`);
+        console.log(`Logs dir:     ${logsBaseDir}`);
+        console.log(`Alert log:    ${effectiveAlertLogPath}`);
         console.log("Runtime monitor is running. Press Ctrl+C to stop.");
       }
       const signal = await runtime2.waitForShutdownSignal();
@@ -4812,8 +5735,42 @@ function createRuntimeCommand(config) {
   });
   runtime.command("status").description("Show runtime process and health status").option("--json").action(async (options) => {
     const asJson = Boolean(options.json);
-    const pid = readRuntimePid(config.dataDir);
+    let pid = readRuntimePid(config.dataDir);
     const meta = readRuntimeMeta(config.dataDir);
+    const recoveryListen = resolveRuntimeRecoveryListen(config);
+    if (!pid) {
+      const fallback = findListeningProcessByPort(recoveryListen);
+      if (fallback && isFiberRuntimeCommand(fallback.command)) {
+        pid = fallback.pid;
+        writeRuntimePid(config.dataDir, pid);
+      } else if (fallback?.command) {
+        const details = fallback.command ? `PID ${fallback.pid} (${fallback.command})` : `PID ${fallback.pid}`;
+        if (asJson) {
+          printJsonError({
+            code: "RUNTIME_PORT_IN_USE",
+            message: `Runtime proxy port is in use by non-fiber-pay process: ${details}`,
+            recoverable: true,
+            suggestion: "Stop that process or use a different --proxy-listen port."
+          });
+        } else {
+          console.log(`Runtime proxy port is in use by non-fiber-pay process: ${details}`);
+        }
+        process.exit(1);
+      } else if (fallback) {
+        const message = `Runtime proxy port is in use by process PID ${fallback.pid}. The owning command could not be determined; inspect this PID manually.`;
+        if (asJson) {
+          printJsonError({
+            code: "RUNTIME_PORT_IN_USE",
+            message,
+            recoverable: true,
+            suggestion: "Inspect the PID owner manually or use a different --proxy-listen port."
+          });
+        } else {
+          console.log(message);
+        }
+        process.exit(1);
+      }
+    }
     if (!pid) {
       if (asJson) {
         printJsonError({
@@ -4844,9 +5801,11 @@ function createRuntimeCommand(config) {
       process.exit(1);
     }
     let rpcStatus;
-    if (meta?.proxyListen) {
+    if (meta?.proxyListen ?? recoveryListen) {
       try {
-        const response = await fetch(`http://${meta.proxyListen}/monitor/status`);
+        const response = await fetch(
+          `http://${meta?.proxyListen ?? recoveryListen}/monitor/status`
+        );
         if (response.ok) {
           rpcStatus = await response.json();
         }
@@ -4874,7 +5833,41 @@ function createRuntimeCommand(config) {
   });
   runtime.command("stop").description("Stop runtime process by PID").option("--json").action(async (options) => {
     const asJson = Boolean(options.json);
-    const pid = readRuntimePid(config.dataDir);
+    let pid = readRuntimePid(config.dataDir);
+    const recoveryListen = resolveRuntimeRecoveryListen(config);
+    if (!pid) {
+      const fallback = findListeningProcessByPort(recoveryListen);
+      if (fallback && isFiberRuntimeCommand(fallback.command)) {
+        pid = fallback.pid;
+        writeRuntimePid(config.dataDir, pid);
+      } else if (fallback?.command) {
+        const details = fallback.command ? `PID ${fallback.pid} (${fallback.command})` : `PID ${fallback.pid}`;
+        if (asJson) {
+          printJsonError({
+            code: "RUNTIME_PORT_IN_USE",
+            message: `Runtime proxy port is in use by non-fiber-pay process: ${details}`,
+            recoverable: true,
+            suggestion: "Stop that process manually; it is not managed by fiber-pay runtime PID files."
+          });
+        } else {
+          console.log(`Runtime proxy port is in use by non-fiber-pay process: ${details}`);
+        }
+        process.exit(1);
+      } else if (fallback) {
+        const message = `Runtime proxy port is in use by process PID ${fallback.pid}. The owning command could not be determined; inspect this PID manually.`;
+        if (asJson) {
+          printJsonError({
+            code: "RUNTIME_PORT_IN_USE",
+            message,
+            recoverable: true,
+            suggestion: "Inspect the PID owner manually; it may not be managed by fiber-pay runtime PID files."
+          });
+        } else {
+          console.log(message);
+        }
+        process.exit(1);
+      }
+    }
     if (!pid) {
       if (asJson) {
         printJsonError({
@@ -4903,14 +5896,19 @@ function createRuntimeCommand(config) {
       }
       process.exit(1);
     }
-    process.kill(pid, "SIGTERM");
-    let attempts = 0;
-    while (isProcessRunning(pid) && attempts < 50) {
-      await new Promise((resolve2) => setTimeout(resolve2, 100));
-      attempts += 1;
-    }
-    if (isProcessRunning(pid)) {
-      process.kill(pid, "SIGKILL");
+    const terminated = await terminateProcess(pid);
+    if (!terminated) {
+      if (asJson) {
+        printJsonError({
+          code: "RUNTIME_STOP_FAILED",
+          message: `Failed to terminate runtime process ${pid}.`,
+          recoverable: true,
+          suggestion: `Try stopping PID ${pid} manually and rerun runtime stop.`
+        });
+      } else {
+        console.log(`Failed to terminate runtime process ${pid}.`);
+      }
+      process.exit(1);
     }
     removeRuntimeFiles(config.dataDir);
     if (asJson) {
@@ -4926,8 +5924,8 @@ function createRuntimeCommand(config) {
 import { Command as Command12 } from "commander";
 
 // src/lib/build-info.ts
-var CLI_VERSION = "0.1.0-rc.4";
-var CLI_COMMIT = "20dc82d290856d411382a4ec30f912b913b4f956";
+var CLI_VERSION = "0.1.0-rc.6";
+var CLI_COMMIT = "632dc5658ea5122cea5af371decc1b758b004461";
 
 // src/commands/version.ts
 function createVersionCommand() {
@@ -4945,6 +5943,64 @@ function createVersionCommand() {
   });
 }
 
+// src/commands/wallet.ts
+import { Command as Command13 } from "commander";
+
+// src/lib/wallet-address.ts
+import { scriptToAddress as scriptToAddress2 } from "@fiber-pay/sdk";
+async function runWalletAddressCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  const address = scriptToAddress2(
+    nodeInfo.default_funding_lock_script,
+    config.network === "mainnet" ? "mainnet" : "testnet"
+  );
+  if (options.json) {
+    printJsonSuccess({ address });
+    return;
+  }
+  console.log("\u2705 Funding address retrieved");
+  console.log(`  Address: ${address}`);
+}
+
+// src/lib/wallet-balance.ts
+async function runWalletBalanceCommand(config, options) {
+  if (!config.ckbRpcUrl) {
+    throw new Error(
+      "CKB RPC URL is not configured. Set FIBER_CKB_RPC_URL or add ckb.rpc_url to config.yml."
+    );
+  }
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  const balanceShannons = await getLockBalanceShannons(
+    config.ckbRpcUrl,
+    nodeInfo.default_funding_lock_script
+  );
+  const balanceCkb = formatShannonsAsCkb(balanceShannons, 8);
+  if (options.json) {
+    printJsonSuccess({
+      balance_ckb: balanceCkb,
+      balance_shannons: balanceShannons.toString()
+    });
+    return;
+  }
+  console.log("\u2705 CKB balance retrieved");
+  console.log(`  Balance: ${balanceCkb} CKB`);
+  console.log(`  Balance (shannons): ${balanceShannons.toString()}`);
+}
+
+// src/commands/wallet.ts
+function createWalletCommand(config) {
+  const wallet = new Command13("wallet").description("Wallet management");
+  wallet.command("address").description("Display the funding address").option("--json").action(async (options) => {
+    await runWalletAddressCommand(config, options);
+  });
+  wallet.command("balance").description("Display the CKB balance").option("--json").action(async (options) => {
+    await runWalletBalanceCommand(config, options);
+  });
+  return wallet;
+}
+
 // src/lib/argv.ts
 var GLOBAL_OPTIONS_WITH_VALUE = /* @__PURE__ */ new Set([
   "--profile",
@@ -5035,6 +6091,14 @@ function applyGlobalOverrides(argv) {
         }
         break;
       }
+      case "--rpc-biscuit-token": {
+        const value = getFlagValue(argv, index);
+        if (value) {
+          process.env.FIBER_RPC_BISCUIT_TOKEN = value;
+          explicitFlags.add("rpcBiscuitToken");
+        }
+        break;
+      }
       case "--network": {
         const value = getFlagValue(argv, index);
         if (value) {
@@ -5074,7 +6138,7 @@ function applyGlobalOverrides(argv) {
   }
   if (!explicitDataDir && profileName) {
     const homeDir = process.env.HOME ?? process.cwd();
-    process.env.FIBER_DATA_DIR = join7(homeDir, ".fiber-pay", "profiles", profileName);
+    process.env.FIBER_DATA_DIR = join9(homeDir, ".fiber-pay", "profiles", profileName);
   }
 }
 function printFatal(error) {
@@ -5102,8 +6166,8 @@ async function main() {
   }
   applyGlobalOverrides(argv);
   const config = getEffectiveConfig(explicitFlags).config;
-  const program = new Command13();
-  program.name("fiber-pay").description("AI Agent Payment SDK for CKB Lightning Network").option("--profile <name>", "Use profile at ~/.fiber-pay/profiles/<name>").option("--data-dir <path>", "Override data directory for all commands").option("--rpc-url <url>", "Override RPC URL for all commands").option("--network <network>", "Override network for all commands (testnet|mainnet)").option("--key-password <password>", "Override key password for all commands").option("--binary-path <path>", "Override fiber binary path for all commands").showHelpAfterError().showSuggestionAfterError();
+  const program = new Command14();
+  program.name("fiber-pay").description("AI Agent Payment SDK for CKB Lightning Network").option("--profile <name>", "Use profile at ~/.fiber-pay/profiles/<name>").option("--data-dir <path>", "Override data directory for all commands").option("--rpc-url <url>", "Override RPC URL for all commands").option("--rpc-biscuit-token <token>", "Set RPC Authorization Bearer token for all commands").option("--network <network>", "Override network for all commands (testnet|mainnet)").option("--key-password <password>", "Override key password for all commands").option("--binary-path <path>", "Override fiber binary path for all commands").showHelpAfterError().showSuggestionAfterError();
   program.exitOverride();
   program.configureOutput({
     writeOut: (str) => process.stdout.write(str),
@@ -5125,6 +6189,7 @@ async function main() {
   program.addCommand(createConfigCommand(config));
   program.addCommand(createRuntimeCommand(config));
   program.addCommand(createVersionCommand());
+  program.addCommand(createWalletCommand(config));
   await program.parseAsync(argv);
 }
 main().catch((error) => {