@cogcoin/client 1.1.3 → 1.1.5

package/dist/cli/output.js

@@ -1,10 +1,8 @@
 import { FileLockBusyError } from "../wallet/fs/lock.js";
+import { describeCanonicalCommandFromArgs } from "./command-registry.js";
 export function writeJsonValue(stream, value) {
     stream.write(`${JSON.stringify(value, jsonReplacer)}\n`);
 }
-export function isStructuredOutputMode(mode) {
-    return mode === "json" || mode === "preview-json";
-}
 function jsonReplacer(_key, value) {
     return typeof value === "bigint" ? value.toString() : value;
 }
@@ -255,7 +253,7 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
     if (errorCode === "reset_wallet_choice_invalid") {
         return {
             what: "Wallet reset choice is invalid.",
-            why: "This reset path accepts only Enter for the default entropy-retaining reset, \"skip\", or \"delete wallet\".",
+            why: "This reset path accepts only Enter for the default entropy-retaining reset, \"skip\", or \"clear wallet entropy\".",
             next: "Rerun `cogcoin reset` and enter one of the accepted wallet reset choices.",
         };
     }
@@ -263,7 +261,7 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
         return {
             what: "Entropy-retaining wallet reset is unavailable.",
             why: "Cogcoin found wallet state, but it could not safely load and reconstruct it into a fresh wallet while preserving only the mnemonic-derived continuity data.",
-            next: "Rerun `cogcoin reset` and choose \"skip\" to keep the wallet unchanged, or type \"delete wallet\" to erase it fully.",
+            next: "Rerun `cogcoin reset` and choose \"skip\" to keep the wallet unchanged, or type \"clear wallet entropy\" to erase it fully.",
         };
     }
     if (errorCode === "reset_process_shutdown_failed") {
@@ -343,39 +341,60 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
             next: "Run `cogcoin client change-password` in an interactive terminal.",
         };
     }
+    if (errorCode === "cli_restore_removed" || errorCode === "cli_wallet_restore_removed") {
+        return {
+            what: "Standalone restore commands were removed.",
+            why: "Cogcoin now uses `cogcoin init` as the single wallet setup entrypoint for both new and restored wallets.",
+            next: "Run `cogcoin init` and choose \"Restore existing wallet\".",
+        };
+    }
+    if (errorCode === "cli_wallet_delete_removed") {
+        return {
+            what: "`wallet delete` was removed.",
+            why: "Cogcoin no longer supports multiple local wallet seeds, so replacing the wallet now flows through reset and init.",
+            next: "Run `cogcoin reset`, choose \"clear wallet entropy\", then rerun `cogcoin init`.",
+        };
+    }
+    if (errorCode === "cli_seed_removed") {
+        return {
+            what: "`--seed` was removed.",
+            why: "Cogcoin now supports only a single local wallet instead of multiple named wallet seeds.",
+            next: "Use the current wallet directly, or run `cogcoin reset`, choose \"clear wallet entropy\", then rerun `cogcoin init` to import a different wallet.",
+        };
+    }
     if (errorCode === "wallet_restore_requires_main_wallet") {
         return {
-            what: "Main wallet is required before importing another seed.",
-            why: "Named restore only creates imported seeds. Cogcoin requires the primary `main` wallet to exist first so shared local state has a canonical default seed.",
-            next: "Run `cogcoin init`, then rerun `cogcoin restore --seed <name>`.",
+            what: "Legacy multi-seed restore is no longer available.",
+            why: "Cogcoin no longer supports restoring into named imported wallet slots.",
+            next: "Run `cogcoin init` and choose \"Restore existing wallet\".",
         };
     }
     if (errorCode === "wallet_seed_name_exists") {
         return {
-            what: "Seed name is already in use.",
-            why: "This machine already has a wallet seed registered with that name.",
-            next: "Choose a different `--seed` name, or delete the imported seed first with `cogcoin wallet delete --seed <name>`.",
+            what: "Legacy multi-seed state is still present.",
+            why: "This machine still has old named-wallet artifacts from the removed multi-seed model.",
+            next: "Run `cogcoin reset`, choose \"clear wallet entropy\", then rerun `cogcoin init`.",
         };
     }
     if (errorCode === "wallet_seed_not_found") {
         return {
-            what: "Seed was not found.",
-            why: "No local wallet seed is registered under that name.",
-            next: "Check `--seed <name>` and retry.",
+            what: "Legacy named-wallet state was not found.",
+            why: "Cogcoin no longer supports selecting named local wallet seeds.",
+            next: "Use the single current wallet, or run `cogcoin reset` and `cogcoin init` to replace it.",
         };
     }
     if (errorCode === "wallet_seed_index_invalid") {
         return {
-            what: "Wallet seed registry is invalid.",
-            why: "Cogcoin could not parse or trust the local seed registry file, so it cannot safely decide which named wallet seed to use.",
-            next: "Run `cogcoin repair`, then retry the command.",
+            what: "Legacy wallet-seed registry is invalid.",
+            why: "Cogcoin found old multi-seed metadata from a removed feature and could not trust it for cleanup decisions.",
+            next: "Run `cogcoin repair`, or reset the wallet state if you intend to replace the local wallet.",
         };
     }
     if (errorCode === "wallet_delete_main_not_supported") {
         return {
-            what: "The main wallet cannot be deleted with `wallet delete`.",
-            why: "This command only removes imported seeds. The canonical `main` wallet is part of the base local client state.",
-            next: "Use `cogcoin reset` if you need to remove the main wallet.",
+            what: "`wallet delete` is no longer available.",
+            why: "Cogcoin no longer supports deleting named imported wallets because the client now has a single local wallet model.",
+            next: "Run `cogcoin reset`, choose \"clear wallet entropy\", then rerun `cogcoin init`.",
         };
     }
     if (errorCode === "local-state-corrupt" || errorCode.includes("repair_required") || errorCode.includes("repair-required")) {
@@ -410,7 +429,7 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
         return {
             what: "Recovery phrase is invalid.",
             why: "Mnemonic-only restore accepts only a valid 24-word English BIP39 phrase with a matching checksum.",
-            next: "Rerun `cogcoin restore --seed <name>` and enter the 24 recovery words in the original order.",
+            next: "Rerun `cogcoin init`, choose \"Restore existing wallet\", and enter the 24 recovery words in the original order.",
         };
     }
     if (errorCode === "wallet_restore_replace_confirmation_required") {
@@ -422,23 +441,23 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
     }
     if (errorCode === "wallet_seed_name_invalid" || errorCode === "wallet_seed_name_reserved" || errorCode === "cli_invalid_seed_name") {
         return {
-            what: "Seed name is invalid.",
-            why: "Wallet seed names must be lowercase slugs like `trading` or `cold-backup`, and `main` is reserved.",
-            next: "Choose a different seed name and retry.",
+            what: "Named wallet seeds were removed.",
+            why: "Cogcoin no longer accepts named local wallet seeds because the client now uses a single wallet model.",
+            next: "Run `cogcoin init` for setup, or reset the wallet first if you need to replace it.",
         };
     }
     if (errorCode === "cli_missing_seed_name") {
         return {
-            what: "A seed name is required.",
-            why: "This command needs `--seed <name>` to identify which imported wallet seed it should restore or delete.",
-            next: "Rerun the command with `--seed <name>`.",
+            what: "Named wallet seeds were removed.",
+            why: "This version of Cogcoin no longer supports `--seed`.",
+            next: "Drop `--seed` and retry, or use reset plus init if you need to replace the wallet.",
         };
     }
     if (errorCode === "cli_seed_not_supported_for_command" || errorCode === "wallet_init_seed_not_supported") {
         return {
-            what: "This command does not support `--seed`.",
-            why: "Only wallet-aware commands are seed-selectable. Global lifecycle and shared service commands still operate on the shared local client state.",
-            next: "Drop `--seed` for this command and retry.",
+            what: "Named wallet seeds were removed.",
+            why: "Cogcoin now operates on a single local wallet instead of multiple named wallet seeds.",
+            next: "Drop `--seed` and retry.",
         };
     }
     if (errorCode === "cli_from_not_supported_for_command") {
@@ -487,7 +506,7 @@ export function createCliErrorPresentation(errorCode, fallbackMessage, error) {
         return {
             what: "`wallet import` is no longer available.",
             why: "Portable encrypted wallet archives were removed from the client, so this version no longer imports wallet state from archive files.",
-            next: "Use `cogcoin restore --seed <name>` with the recovery mnemonic instead.",
+            next: "Use `cogcoin init`, choose \"Restore existing wallet\", and enter the recovery mnemonic instead.",
         };
     }
     if (errorCode === "cli_field_create_initial_value_not_supported") {
@@ -954,460 +973,12 @@ function classifiedAsBlockedMessage(errorCode) {
     return isBlockedError(errorCode);
 }
 export function describeCanonicalCommand(parsed) {
-    const args = parsed.args;
-    switch (parsed.command) {
-        case "init":
-        case "wallet-init":
-            return "cogcoin init";
-        case "restore":
-        case "wallet-restore":
-            return "cogcoin restore";
-        case "wallet-delete":
-            return "cogcoin wallet delete";
-        case "wallet-show-mnemonic":
-            return "cogcoin wallet show-mnemonic";
-        case "client-unlock":
-            return "cogcoin client unlock";
-        case "client-lock":
-            return "cogcoin client lock";
-        case "client-change-password":
-            return "cogcoin client change-password";
-        case "bitcoin-transfer":
-            return `cogcoin bitcoin transfer ${args[0] ?? "<sats>"}`;
-        case "reset":
-            return "cogcoin reset";
-        case "repair":
-            return "cogcoin repair";
-        case "update":
-            return "cogcoin update";
-        case "anchor":
-        case "domain-anchor":
-            return `cogcoin anchor ${args[0] ?? "<domain>"}`;
-        case "register":
-        case "domain-register":
-            return `cogcoin register ${args[0] ?? "<domain>"}`;
-        case "transfer":
-        case "domain-transfer":
-            return `cogcoin transfer ${args[0] ?? "<domain>"}`;
-        case "sell":
-        case "domain-sell":
-            return `cogcoin sell ${args[0] ?? "<domain>"} ${args[1] ?? "<price>"}`;
-        case "unsell":
-        case "domain-unsell":
-            return `cogcoin unsell ${args[0] ?? "<domain>"}`;
-        case "buy":
-        case "domain-buy":
-            return `cogcoin buy ${args[0] ?? "<domain>"}`;
-        case "send":
-        case "cog-send":
-            return `cogcoin send ${args[0] ?? "<amount>"}`;
-        case "claim":
-        case "cog-claim":
-            return `cogcoin claim ${args[0] ?? "<lock-id>"}`;
-        case "reclaim":
-        case "cog-reclaim":
-            return `cogcoin reclaim ${args[0] ?? "<lock-id>"}`;
-        case "cog-lock":
-            return `cogcoin cog lock ${args[0] ?? "<amount>"}`;
-        case "domain-endpoint-set":
-            return `cogcoin domain endpoint set ${args[0] ?? "<domain>"}`;
-        case "domain-endpoint-clear":
-            return `cogcoin domain endpoint clear ${args[0] ?? "<domain>"}`;
-        case "domain-delegate-set":
-            return `cogcoin domain delegate set ${args[0] ?? "<domain>"} ${args[1] ?? "<btc-target>"}`;
-        case "domain-delegate-clear":
-            return `cogcoin domain delegate clear ${args[0] ?? "<domain>"}`;
-        case "domain-miner-set":
-            return `cogcoin domain miner set ${args[0] ?? "<domain>"} ${args[1] ?? "<btc-target>"}`;
-        case "domain-miner-clear":
-            return `cogcoin domain miner clear ${args[0] ?? "<domain>"}`;
-        case "domain-canonical":
-            return `cogcoin domain canonical ${args[0] ?? "<domain>"}`;
-        case "field-create":
-            return `cogcoin field create ${args[0] ?? "<domain>"} ${args[1] ?? "<field>"}`;
-        case "field-set":
-            return `cogcoin field set ${args[0] ?? "<domain>"} ${args[1] ?? "<field>"}`;
-        case "field-clear":
-            return `cogcoin field clear ${args[0] ?? "<domain>"} ${args[1] ?? "<field>"}`;
-        case "rep-give":
-            return `cogcoin rep give ${args[0] ?? "<source-domain>"} ${args[1] ?? "<target-domain>"} ${args[2] ?? "<amount>"}`;
-        case "rep-revoke":
-            return `cogcoin rep revoke ${args[0] ?? "<source-domain>"} ${args[1] ?? "<target-domain>"} ${args[2] ?? "<amount>"}`;
-        case "wallet-address":
-        case "address":
-            return "cogcoin address";
-        case "wallet-ids":
-        case "ids":
-            return "cogcoin ids";
-        case "wallet-status":
-            return "cogcoin wallet status";
-        case "mine-setup":
-            return "cogcoin mine setup";
-        case "mine-prompt":
-            return `cogcoin mine prompt ${args[0] ?? "<domain>"}`;
-        case "mine-prompt-list":
-            return "cogcoin mine prompt";
-        case "mine-start":
-            return "cogcoin mine start";
-        case "mine-stop":
-            return "cogcoin mine stop";
-        case "mine-status":
-            return "cogcoin mine status";
-        case "mine-log":
-            return `cogcoin mine log${parsed.follow ? " --follow" : ""}`;
-        case "cog-balance":
-        case "balance":
-            return "cogcoin balance";
-        case "cog-locks":
-        case "locks":
-            return "cogcoin locks";
-        case "field-list":
-        case "fields":
-            return `cogcoin fields ${args[0] ?? "<domain>"}`;
-        case "field-show":
-        case "field":
-            return `cogcoin field ${args[0] ?? "<domain>"} ${args[1] ?? "<field>"}`;
-        case "domain-show":
-        case "show":
-            return `cogcoin show ${args[0] ?? "<domain>"}`;
-        case "status":
-            return "cogcoin status";
-        case "domain-list":
-        case "domains":
-            return "cogcoin domains";
-        default:
-            return parsed.command === null ? "cogcoin" : `cogcoin ${parsed.command.replaceAll("-", " ")}`;
-    }
-}
-export function inferOutputMode(argv) {
-    const index = argv.lastIndexOf("--output");
-    if (index === -1) {
-        return "text";
-    }
-    const value = argv[index + 1];
-    if (value === "json" || value === "preview-json") {
-        return value;
-    }
-    return "text";
-}
-export function resolveStableJsonSchema(parsed) {
-    switch (parsed.command) {
-        case "status":
-            return "cogcoin/status/v1";
-        case "bitcoin-start":
-            return "cogcoin/bitcoin-start/v1";
-        case "bitcoin-stop":
-            return "cogcoin/bitcoin-stop/v1";
-        case "bitcoin-status":
-            return "cogcoin/bitcoin-status/v1";
-        case "indexer-start":
-            return "cogcoin/indexer-start/v1";
-        case "indexer-stop":
-            return "cogcoin/indexer-stop/v1";
-        case "indexer-status":
-            return "cogcoin/indexer-status/v1";
-        case "wallet-address":
-        case "address":
-            return "cogcoin/address/v1";
-        case "wallet-ids":
-        case "ids":
-            return "cogcoin/ids/v1";
-        case "wallet-status":
-            return "cogcoin/wallet-status/v1";
-        case "mine-status":
-            return "cogcoin/mine-status/v1";
-        case "mine-log":
-            return "cogcoin/mine-log/v1";
-        case "mine-prompt-list":
-            return "cogcoin/mine-prompt-list/v1";
-        case "balance":
-        case "cog-balance":
-            return "cogcoin/balance/v1";
-        case "locks":
-        case "cog-locks":
-            return "cogcoin/locks/v1";
-        case "domain-list":
-        case "domains":
-            return "cogcoin/domains/v1";
-        case "domain-show":
-        case "show":
-            return "cogcoin/show/v1";
-        case "fields":
-        case "field-list":
-            return "cogcoin/fields/v1";
-        case "field":
-        case "field-show":
-            return "cogcoin/field/v1";
-        default:
-            return null;
-    }
-}
-export function resolveStableMutationJsonSchema(parsed) {
-    switch (parsed.command) {
-        case "init":
-        case "wallet-init":
-            return "cogcoin/init/v1";
-        case "restore":
-        case "wallet-restore":
-            return "cogcoin/restore/v1";
-        case "client-unlock":
-            return "cogcoin/client-unlock/v1";
-        case "client-lock":
-            return "cogcoin/client-lock/v1";
-        case "client-change-password":
-            return "cogcoin/client-change-password/v1";
-        case "bitcoin-transfer":
-            return "cogcoin/bitcoin-transfer/v1";
-        case "wallet-delete":
-            return "cogcoin/wallet-delete/v1";
-        case "reset":
-            return "cogcoin/reset/v1";
-        case "repair":
-            return "cogcoin/repair/v1";
-        case "update":
-            return "cogcoin/update/v1";
-        case "anchor":
-        case "domain-anchor":
-            return "cogcoin/anchor/v1";
-        case "register":
-        case "domain-register":
-            return "cogcoin/register/v1";
-        case "transfer":
-        case "domain-transfer":
-            return "cogcoin/transfer/v1";
-        case "sell":
-        case "domain-sell":
-            return "cogcoin/sell/v1";
-        case "unsell":
-        case "domain-unsell":
-            return "cogcoin/unsell/v1";
-        case "buy":
-        case "domain-buy":
-            return "cogcoin/buy/v1";
-        case "send":
-        case "cog-send":
-            return "cogcoin/send/v1";
-        case "claim":
-        case "cog-claim":
-            return "cogcoin/claim/v1";
-        case "reclaim":
-        case "cog-reclaim":
-            return "cogcoin/reclaim/v1";
-        case "cog-lock":
-            return "cogcoin/cog-lock/v1";
-        case "domain-endpoint-set":
-            return "cogcoin/domain-endpoint-set/v1";
-        case "domain-endpoint-clear":
-            return "cogcoin/domain-endpoint-clear/v1";
-        case "domain-delegate-set":
-            return "cogcoin/domain-delegate-set/v1";
-        case "domain-delegate-clear":
-            return "cogcoin/domain-delegate-clear/v1";
-        case "domain-miner-set":
-            return "cogcoin/domain-miner-set/v1";
-        case "domain-miner-clear":
-            return "cogcoin/domain-miner-clear/v1";
-        case "domain-canonical":
-            return "cogcoin/domain-canonical/v1";
-        case "field-create":
-            return "cogcoin/field-create/v1";
-        case "field-set":
-            return "cogcoin/field-set/v1";
-        case "field-clear":
-            return "cogcoin/field-clear/v1";
-        case "rep-give":
-            return "cogcoin/rep-give/v1";
-        case "rep-revoke":
-            return "cogcoin/rep-revoke/v1";
-        default:
-            return null;
-    }
-}
-export function resolveStableMiningControlJsonSchema(parsed) {
-    switch (parsed.command) {
-        case "mine-setup":
-            return "cogcoin/mine-setup/v1";
-        case "mine-prompt":
-            return "cogcoin/mine-prompt/v1";
-        case "mine-start":
-            return "cogcoin/mine-start/v1";
-        case "mine-stop":
-            return "cogcoin/mine-stop/v1";
-        default:
-            return null;
-    }
-}
-export function resolvePreviewJsonSchema(parsed) {
-    const stableMutationSchema = resolveStableMutationJsonSchema(parsed);
-    const stableMiningControlSchema = resolveStableMiningControlJsonSchema(parsed);
-    switch (parsed.command) {
-        case "reset":
-        case "repair":
-        case "anchor":
-        case "domain-anchor":
-        case "register":
-        case "domain-register":
-        case "transfer":
-        case "domain-transfer":
-        case "sell":
-        case "domain-sell":
-        case "unsell":
-        case "domain-unsell":
-        case "buy":
-        case "domain-buy":
-        case "send":
-        case "cog-send":
-        case "claim":
-        case "cog-claim":
-        case "reclaim":
-        case "cog-reclaim":
-        case "cog-lock":
-        case "domain-endpoint-set":
-        case "domain-endpoint-clear":
-        case "domain-delegate-set":
-        case "domain-delegate-clear":
-        case "domain-miner-set":
-        case "domain-miner-clear":
-        case "domain-canonical":
-        case "field-create":
-        case "field-set":
-        case "field-clear":
-        case "rep-give":
-        case "rep-revoke":
-            return stableMutationSchema === null
-                ? null
-                : stableMutationSchema.replace(/^cogcoin\//, "cogcoin-preview/");
-        case "mine-setup":
-        case "mine-start":
-        case "mine-stop":
-            return stableMiningControlSchema === null
-                ? null
-                : stableMiningControlSchema.replace(/^cogcoin\//, "cogcoin-preview/");
-        default:
-            return null;
-    }
-}
-function createSchemaProbe(command) {
-    return {
-        command,
-        args: [],
-        help: false,
-        version: false,
-        outputMode: "json",
-        dbPath: null,
-        dataDir: null,
-        progressOutput: "auto",
-        seedName: null,
-        unlockFor: null,
-        assumeYes: false,
-        force: false,
-        forceRace: false,
-        anchorMessage: null,
-        transferTarget: null,
-        endpointText: null,
-        endpointJson: null,
-        endpointBytes: null,
-        fieldPermanent: false,
-        fieldFormat: null,
-        fieldValue: null,
-        lockRecipientDomain: null,
-        conditionHex: null,
-        untilHeight: null,
-        preimageHex: null,
-        reviewText: null,
-        satvb: null,
-        locksClaimableOnly: false,
-        locksReclaimableOnly: false,
-        domainsAnchoredOnly: false,
-        domainsListedOnly: false,
-        domainsMineableOnly: false,
-        listLimit: null,
-        listAll: false,
-        follow: false,
-    };
-}
-function isStableJsonCommand(command) {
-    return resolveStableJsonSchema(createSchemaProbe(command)) !== null;
-}
-function isStableMutationJsonCommand(command) {
-    return resolveStableMutationJsonSchema(createSchemaProbe(command)) !== null;
-}
-function isStableMiningControlJsonCommand(command) {
-    return resolveStableMiningControlJsonSchema(createSchemaProbe(command)) !== null;
-}
-function isPreviewJsonCommand(command) {
-    return resolvePreviewJsonSchema(createSchemaProbe(command)) !== null;
-}
-export function isJsonOutputSupportedCommand(command) {
-    return isStableJsonCommand(command)
-        || isStableMutationJsonCommand(command)
-        || isStableMiningControlJsonCommand(command)
-        || isPreviewJsonCommand(command);
-}
-export function isPreviewJsonOutputSupportedCommand(command) {
-    return isPreviewJsonCommand(command);
-}
-export function createCommandJsonErrorEnvelope(parsed, error) {
-    const classified = classifyCliError(error);
-    const presentation = createCliErrorPresentation(classified.errorCode, classified.message, error);
-    const humanMessage = presentation?.what ?? classified.message;
-    const explanations = presentation?.why === null || presentation?.why === undefined ? [] : [presentation.why];
-    const nextSteps = presentation?.next === null || presentation?.next === undefined ? [] : [presentation.next];
-    const details = createCliErrorDetails(classified.errorCode, humanMessage, classified.message);
-    const stableMutationSchema = resolveStableMutationJsonSchema(parsed);
-    const stableMiningControlSchema = resolveStableMiningControlJsonSchema(parsed);
-    const previewSchema = resolvePreviewJsonSchema(parsed);
-    if (parsed.outputMode === "preview-json" && previewSchema !== null) {
-        return createPreviewErrorEnvelope(previewSchema, describeCanonicalCommand(parsed), classified.errorCode, humanMessage, {
-            explanations,
-            nextSteps,
-            details,
-        });
-    }
-    if (stableMutationSchema !== null) {
-        return createMutationErrorEnvelope(stableMutationSchema, describeCanonicalCommand(parsed), classified.errorCode, humanMessage, {
-            explanations,
-            nextSteps,
-            details,
-        });
-    }
-    if (stableMiningControlSchema !== null) {
-        return createMutationErrorEnvelope(stableMiningControlSchema, describeCanonicalCommand(parsed), classified.errorCode, humanMessage, {
-            explanations,
-            nextSteps,
-            details,
-        });
-    }
-    if (previewSchema !== null) {
-        return createPreviewErrorEnvelope(previewSchema, describeCanonicalCommand(parsed), classified.errorCode, humanMessage, {
-            explanations,
-            nextSteps,
-            details,
-        });
-    }
-    return createErrorEnvelope(resolveStableJsonSchema(parsed) ?? "cogcoin/cli/v1", describeCanonicalCommand(parsed), classified.errorCode, humanMessage, {
-        explanations,
-        nextSteps,
-        details,
+    return describeCanonicalCommandFromArgs(parsed.command, parsed.args, {
+        follow: parsed.follow,
     });
 }
-function createCliErrorDetails(errorCode, humanMessage, rawMessage) {
-    const details = {};
-    const initMatch = /^wallet_init_confirmation_failed_word_(\d+)$/.exec(errorCode);
-    if (initMatch !== null) {
-        details.wordIndex = Number.parseInt(initMatch[1], 10);
-    }
-    if (humanMessage !== rawMessage) {
-        details.rawMessage = rawMessage;
-    }
-    return details;
-}
 export function writeHandledCliError(options) {
     const classified = classifyCliError(options.error);
-    if (isStructuredOutputMode(options.parsed.outputMode)) {
-        writeJsonValue(options.stdout, createCommandJsonErrorEnvelope(options.parsed, options.error));
-        return classified.exitCode;
-    }
     const formatted = formatCliTextError(options.error);
     if (formatted !== null) {
         for (const line of formatted) {

package/dist/cli/parse.d.ts

@@ -1,3 +1,3 @@
 import type { ParsedCliArgs } from "./types.js";
-export declare const HELP_TEXT = "Usage: cogcoin <command> [options]\n\nCommands:\n  status                  Show wallet-aware local service and chain status\n  status --output json    Emit the stable v1 machine-readable status envelope\n  update                  Show the current and latest client versions and install updates\n  update --output json    Emit the stable v1 machine-readable update result envelope\n  client unlock           Unlock password-protected local wallet secrets for a limited time\n  client lock             Flush the cached client password unlock session\n  client change-password  Rotate the client password that protects local wallet secrets\n  bitcoin start           Start the managed Bitcoin daemon\n  bitcoin stop            Stop the managed Bitcoin daemon and paired indexer\n  bitcoin status          Show managed Bitcoin daemon status without starting it\n  bitcoin transfer <sats> --to <address>\n                         Send plain BTC from the wallet address\n  indexer start           Start the managed Cogcoin indexer (and bitcoind if needed)\n  indexer stop            Stop the managed Cogcoin indexer only\n  indexer status          Show managed Cogcoin indexer status without starting it\n  init                    Initialize a new local wallet root\n  init --output json      Emit the stable v1 machine-readable init result envelope\n  restore                 Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  reset                   Factory-reset local Cogcoin state with interactive retention prompts\n  repair                  Recover bounded wallet/indexer/runtime state\n  wallet address          Alias for address\n  wallet ids              Alias for ids\n  mine                    Run the miner in the foreground\n  mine start              Start the miner as a background worker\n  mine stop               Stop the active background miner\n  mine setup              Configure the built-in mining provider\n  mine setup --output json\n                         Emit the stable v1 machine-readable mine setup result envelope\n  mine prompt             Show per-domain mining prompt state\n  mine prompt --output json\n                         Emit the stable v1 machine-readable mine prompt list envelope\n  mine prompt <domain>    Configure a per-domain mining prompt override\n  mine prompt <domain> --output json\n                         Emit the stable v1 machine-readable mine prompt result envelope\n  mine prompt list        Alias for mine prompt\n  mine status             Show mining control-plane health and readiness\n  mine log                Show recent mining control-plane events\n  anchor <domain>         Anchor an owned unanchored domain with the wallet address\n  register <domain>\n                         Register a root domain or subdomain\n  transfer <domain> --to <btc-target>\n                          Transfer an unanchored domain to another BTC address or script\n  sell <domain> <price>   List an unanchored domain for sale in COG\n  unsell <domain>         Clear an active domain listing\n  buy <domain>\n                         Buy an unanchored listed domain in COG\n  send <amount> --to <btc-target>\n                         Send COG from the wallet address to another BTC target\n  claim <lock-id> --preimage <32-byte-hex>\n                         Claim an active COG lock before timeout\n  reclaim <lock-id>      Reclaim an expired COG lock as the original locker\n  cog lock <amount> --to-domain <domain> (--for <blocks-or-duration> | --until-height <height>) --condition <sha256hex>\n                         Lock COG to an anchored recipient domain\n  wallet status           Show detailed wallet-local status and service health\n  wallet init             Initialize a new local wallet root\n  wallet restore          Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  wallet delete           Delete one imported named seed without affecting main\n  wallet show-mnemonic    Reveal the initialized wallet recovery phrase after typed confirmation\n  address                 Show the BTC wallet address for this wallet\n  ids                     Show the local wallet address\n  balance                 Show local wallet COG balances\n  locks                   Show locally related active COG locks\n  domain list             Alias for domains\n  domain show <domain>    Alias for show <domain>\n  domains [--anchored] [--listed] [--mineable]\n                         Show locally related domains\n  show <domain>           Show one domain and its local-wallet relationship\n  fields <domain>         List current fields on a domain\n  field <domain> <field>  Show one current field value\n  field create <domain> <field>\n                         Create a new empty anchored field\n  field set <domain> <field>\n                         Update an existing anchored field value\n  field clear <domain> <field>\n                         Clear an existing anchored field value\n  rep give <source-domain> <target-domain> <amount>\n                         Burn COG as anchored-domain reputation support\n  rep revoke <source-domain> <target-domain> <amount>\n                         Revoke visible support without refunding burned COG\n\nOptions:\n  --db <path>       Override the SQLite database path\n  --data-dir <path> Override the managed bitcoin datadir\n  --for <duration>  Relative timeout for cog lock, like 15m, 2h, or 1d\n  --message <text>  Founding message text for anchor\n  --to <btc-target> Transfer or send target as an address or spk:<hex>\n  --to-domain <domain>\n                    Recipient domain for cog lock\n  --condition <sha256hex>\n                    32-byte lock condition hash\n  --until-height <height>\n                    Absolute timeout height for cog lock\n  --preimage <32-byte-hex>\n                    Claim preimage for an active lock\n  --review <text>   Optional public review text for reputation operations\n  --satvb <n>       Override the mutation fee rate in sat/vB\n  --text <utf8>     UTF-8 payload text for endpoint or field writes\n  --json <json>     UTF-8 payload JSON text for endpoint or field writes\n  --bytes <spec>    Payload bytes as hex:<hex> or @<path>\n  --permanent       Create the field as permanent\n  --format <spec>   Advanced field format as raw:<u8>\n  --value <spec>    Advanced field value as hex:<hex>, @<path>, or utf8:<text>\n  --claimable      Show only currently claimable locks\n  --reclaimable    Show only currently reclaimable locks\n  --anchored       Show only anchored domains\n  --listed         Show only currently listed domains\n  --mineable       Show only locally mineable root domains\n  --limit <n>      Limit list rows (1..1000)\n  --all            Show all rows for list commands\n  --follow         Follow mining log output\n  --output <mode>  Output mode: text, json, or preview-json\n  --progress <mode> Progress output mode: auto, tty, or none\n  --seed <name>    Select an imported wallet seed for wallet-aware commands\n  --force          Reserved for future use\n  --force-race      Allow a visible root registration race\n  --yes             Approve eligible plain yes/no mutation confirmations non-interactively\n  --help            Show help\n  --version         Show package version\n\nQuickstart:\n  1. Run `cogcoin init` to create the wallet.\n  2. Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.\n  3. Run `cogcoin address`, then fund the wallet with about 0.0015 BTC so you can buy a 6+ character domain to start mining and still keep BTC available for mining transaction fees.\n\nExamples:\n  cogcoin status --output json\n  cogcoin bitcoin status\n  cogcoin indexer status\n  cogcoin init --output json\n  cogcoin restore --seed trading\n  cogcoin wallet address\n  cogcoin domain list --mineable\n  cogcoin register alpha-child\n  cogcoin anchor alpha\n  cogcoin register alpha --satvb 12.5\n  cogcoin buy alpha\n  cogcoin field set alpha bio --text \"hello\"\n  cogcoin rep give alpha beta 10 --review \"great operator\"\n  cogcoin mine setup --output json\n  cogcoin mine prompt\n  cogcoin mine prompt alpha\n  cogcoin register alpha-child --output preview-json\n  cogcoin mine status\n";
+export declare const HELP_TEXT: string;
 export declare function parseCliArgs(argv: string[]): ParsedCliArgs;