@trading-boy/cli 1.2.16 → 1.2.17

package/dist/cli.bundle.js

@@ -3711,9 +3711,9 @@ var init_source = __esm({
     init_supports_color();
     init_utilities();
     ({ stdout: stdoutColor, stderr: stderrColor } = supports_color_default);
-    GENERATOR = /* @__PURE__ */ Symbol("GENERATOR");
-    STYLER = /* @__PURE__ */ Symbol("STYLER");
-    IS_EMPTY = /* @__PURE__ */ Symbol("IS_EMPTY");
+    GENERATOR = Symbol("GENERATOR");
+    STYLER = Symbol("STYLER");
+    IS_EMPTY = Symbol("IS_EMPTY");
     levelMapping = [
       "ansi",
       "ansi",
@@ -4310,8 +4310,8 @@ var require_err_helpers = __commonJS({
 var require_err_proto = __commonJS({
   "../../node_modules/.pnpm/pino-std-serializers@7.1.0/node_modules/pino-std-serializers/lib/err-proto.js"(exports, module) {
     "use strict";
-    var seen = /* @__PURE__ */ Symbol("circular-ref-tag");
-    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-err-ref");
+    var seen = Symbol("circular-ref-tag");
+    var rawSymbol = Symbol("pino-raw-err-ref");
     var pinoErrProto = Object.create({}, {
       type: {
         enumerable: true,
@@ -4448,7 +4448,7 @@ var require_req = __commonJS({
       mapHttpRequest,
       reqSerializer
     };
-    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-req-ref");
+    var rawSymbol = Symbol("pino-raw-req-ref");
     var pinoReqProto = Object.create({}, {
       id: {
         enumerable: true,
@@ -4543,7 +4543,7 @@ var require_res = __commonJS({
       mapHttpResponse,
       resSerializer
     };
-    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-res-ref");
+    var rawSymbol = Symbol("pino-raw-res-ref");
     var pinoResProto = Object.create({}, {
       statusCode: {
         enumerable: true,
@@ -4785,7 +4785,7 @@ var require_redact = __commonJS({
       }
       return true;
     }
-    var PATH_NOT_FOUND = /* @__PURE__ */ Symbol("PATH_NOT_FOUND");
+    var PATH_NOT_FOUND = Symbol("PATH_NOT_FOUND");
     function getValueIfExists(obj, parts) {
       let current = obj;
       for (const part of parts) {
@@ -5086,37 +5086,37 @@ var require_redact = __commonJS({
 var require_symbols = __commonJS({
   "../../node_modules/.pnpm/pino@10.3.1/node_modules/pino/lib/symbols.js"(exports, module) {
     "use strict";
-    var setLevelSym = /* @__PURE__ */ Symbol("pino.setLevel");
-    var getLevelSym = /* @__PURE__ */ Symbol("pino.getLevel");
-    var levelValSym = /* @__PURE__ */ Symbol("pino.levelVal");
-    var levelCompSym = /* @__PURE__ */ Symbol("pino.levelComp");
-    var useLevelLabelsSym = /* @__PURE__ */ Symbol("pino.useLevelLabels");
-    var useOnlyCustomLevelsSym = /* @__PURE__ */ Symbol("pino.useOnlyCustomLevels");
-    var mixinSym = /* @__PURE__ */ Symbol("pino.mixin");
-    var lsCacheSym = /* @__PURE__ */ Symbol("pino.lsCache");
-    var chindingsSym = /* @__PURE__ */ Symbol("pino.chindings");
-    var asJsonSym = /* @__PURE__ */ Symbol("pino.asJson");
-    var writeSym = /* @__PURE__ */ Symbol("pino.write");
-    var redactFmtSym = /* @__PURE__ */ Symbol("pino.redactFmt");
-    var timeSym = /* @__PURE__ */ Symbol("pino.time");
-    var timeSliceIndexSym = /* @__PURE__ */ Symbol("pino.timeSliceIndex");
-    var streamSym = /* @__PURE__ */ Symbol("pino.stream");
-    var stringifySym = /* @__PURE__ */ Symbol("pino.stringify");
-    var stringifySafeSym = /* @__PURE__ */ Symbol("pino.stringifySafe");
-    var stringifiersSym = /* @__PURE__ */ Symbol("pino.stringifiers");
-    var endSym = /* @__PURE__ */ Symbol("pino.end");
-    var formatOptsSym = /* @__PURE__ */ Symbol("pino.formatOpts");
-    var messageKeySym = /* @__PURE__ */ Symbol("pino.messageKey");
-    var errorKeySym = /* @__PURE__ */ Symbol("pino.errorKey");
-    var nestedKeySym = /* @__PURE__ */ Symbol("pino.nestedKey");
-    var nestedKeyStrSym = /* @__PURE__ */ Symbol("pino.nestedKeyStr");
-    var mixinMergeStrategySym = /* @__PURE__ */ Symbol("pino.mixinMergeStrategy");
-    var msgPrefixSym = /* @__PURE__ */ Symbol("pino.msgPrefix");
-    var wildcardFirstSym = /* @__PURE__ */ Symbol("pino.wildcardFirst");
-    var serializersSym = /* @__PURE__ */ Symbol.for("pino.serializers");
-    var formattersSym = /* @__PURE__ */ Symbol.for("pino.formatters");
-    var hooksSym = /* @__PURE__ */ Symbol.for("pino.hooks");
-    var needsMetadataGsym = /* @__PURE__ */ Symbol.for("pino.metadata");
+    var setLevelSym = Symbol("pino.setLevel");
+    var getLevelSym = Symbol("pino.getLevel");
+    var levelValSym = Symbol("pino.levelVal");
+    var levelCompSym = Symbol("pino.levelComp");
+    var useLevelLabelsSym = Symbol("pino.useLevelLabels");
+    var useOnlyCustomLevelsSym = Symbol("pino.useOnlyCustomLevels");
+    var mixinSym = Symbol("pino.mixin");
+    var lsCacheSym = Symbol("pino.lsCache");
+    var chindingsSym = Symbol("pino.chindings");
+    var asJsonSym = Symbol("pino.asJson");
+    var writeSym = Symbol("pino.write");
+    var redactFmtSym = Symbol("pino.redactFmt");
+    var timeSym = Symbol("pino.time");
+    var timeSliceIndexSym = Symbol("pino.timeSliceIndex");
+    var streamSym = Symbol("pino.stream");
+    var stringifySym = Symbol("pino.stringify");
+    var stringifySafeSym = Symbol("pino.stringifySafe");
+    var stringifiersSym = Symbol("pino.stringifiers");
+    var endSym = Symbol("pino.end");
+    var formatOptsSym = Symbol("pino.formatOpts");
+    var messageKeySym = Symbol("pino.messageKey");
+    var errorKeySym = Symbol("pino.errorKey");
+    var nestedKeySym = Symbol("pino.nestedKey");
+    var nestedKeyStrSym = Symbol("pino.nestedKeyStr");
+    var mixinMergeStrategySym = Symbol("pino.mixinMergeStrategy");
+    var msgPrefixSym = Symbol("pino.msgPrefix");
+    var wildcardFirstSym = Symbol("pino.wildcardFirst");
+    var serializersSym = Symbol.for("pino.serializers");
+    var formattersSym = Symbol.for("pino.formatters");
+    var hooksSym = Symbol.for("pino.hooks");
+    var needsMetadataGsym = Symbol.for("pino.metadata");
     module.exports = {
       setLevelSym,
       getLevelSym,
@@ -6241,7 +6241,7 @@ var require_thread_stream = __commonJS({
     } = require_indexes();
     var buffer = __require("buffer");
     var assert2 = __require("assert");
-    var kImpl = /* @__PURE__ */ Symbol("kImpl");
+    var kImpl = Symbol("kImpl");
     var MAX_STRING = buffer.constants.MAX_STRING_LENGTH;
     var FakeWeakRef = class {
       constructor(value) {
@@ -8257,7 +8257,7 @@ ${originalIndentation}`;
 var require_multistream = __commonJS({
   "../../node_modules/.pnpm/pino@10.3.1/node_modules/pino/lib/multistream.js"(exports, module) {
     "use strict";
-    var metadata = /* @__PURE__ */ Symbol.for("pino.metadata");
+    var metadata = Symbol.for("pino.metadata");
     var { DEFAULT_LEVELS } = require_constants();
     var DEFAULT_INFO_LEVEL = DEFAULT_LEVELS.info;
     function multistream(streamsArray, opts) {
@@ -8754,7 +8754,7 @@ var init_mjs = __esm({
   "../../node_modules/.pnpm/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/index.js"() {
     init_signals();
     processOk = (process17) => !!process17 && typeof process17 === "object" && typeof process17.removeListener === "function" && typeof process17.emit === "function" && typeof process17.reallyExit === "function" && typeof process17.listeners === "function" && typeof process17.kill === "function" && typeof process17.pid === "number" && typeof process17.on === "function";
-    kExitEmitter = /* @__PURE__ */ Symbol.for("signal-exit emitter");
+    kExitEmitter = Symbol.for("signal-exit emitter");
     global2 = globalThis;
     ObjectDefineProperty = Object.defineProperty.bind(Object);
     Emitter = class {
@@ -19921,7 +19921,7 @@ var require_utils = __commonJS({
 var require_lib2 = __commonJS({
   "../../node_modules/.pnpm/chardet@2.1.1/node_modules/chardet/lib/index.js"(exports) {
     "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
       var desc = Object.getOwnPropertyDescriptor(m, k);
       if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
@@ -19930,16 +19930,16 @@ var require_lib2 = __commonJS({
         } };
       }
       Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
+    } : function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
       o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+    });
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
       Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
+    } : function(o, v) {
       o["default"] = v;
     });
-    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
       var ownKeys = function(o) {
         ownKeys = Object.getOwnPropertyNames || function(o2) {
           var ar = [];
@@ -19957,7 +19957,7 @@ var require_lib2 = __commonJS({
         __setModuleDefault(result, mod);
         return result;
       };
-    })();
+    }();
     var __importDefault = exports && exports.__importDefault || function(mod) {
       return mod && mod.__esModule ? mod : { "default": mod };
     };
@@ -25905,6 +25905,17 @@ var PlanStatus;
   PlanStatus2["EXPIRED"] = "EXPIRED";
   PlanStatus2["CANCELLED"] = "CANCELLED";
 })(PlanStatus || (PlanStatus = {}));
+var Chamber;
+(function(Chamber2) {
+  Chamber2["HOUSE"] = "HOUSE";
+  Chamber2["SENATE"] = "SENATE";
+})(Chamber || (Chamber = {}));
+var PoliticianTransactionType;
+(function(PoliticianTransactionType2) {
+  PoliticianTransactionType2["BUY"] = "BUY";
+  PoliticianTransactionType2["SELL"] = "SELL";
+  PoliticianTransactionType2["EXERCISE"] = "EXERCISE";
+})(PoliticianTransactionType || (PoliticianTransactionType = {}));
 var NotificationChannel;
 (function(NotificationChannel2) {
   NotificationChannel2["TELEGRAM"] = "TELEGRAM";
@@ -26530,7 +26541,7 @@ function $constructor(name, initializer3, params) {
   Object.defineProperty(_, "name", { value: name });
   return _;
 }
-var $brand = /* @__PURE__ */ Symbol("zod_brand");
+var $brand = Symbol("zod_brand");
 var $ZodAsyncError = class extends Error {
   constructor() {
     super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
@@ -26677,7 +26688,7 @@ function floatSafeRemainder(val, step) {
   const stepInt = Number.parseInt(step.toFixed(decCount).replace(".", ""));
   return valInt % stepInt / 10 ** decCount;
 }
-var EVALUATING = /* @__PURE__ */ Symbol("evaluating");
+var EVALUATING = Symbol("evaluating");
 function defineLazy(object2, key, getter) {
   let value = void 0;
   Object.defineProperty(object2, key, {
@@ -35750,8 +35761,8 @@ function yo_default() {
 
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.js
 var _a;
-var $output = /* @__PURE__ */ Symbol("ZodOutput");
-var $input = /* @__PURE__ */ Symbol("ZodInput");
+var $output = Symbol("ZodOutput");
+var $input = Symbol("ZodInput");
 var $ZodRegistry = class {
   constructor() {
     this._map = /* @__PURE__ */ new WeakMap();
@@ -36788,7 +36799,7 @@ function _stringbool(Classes, _params) {
     type: "pipe",
     in: stringSchema,
     out: booleanSchema,
-    transform: ((input, payload) => {
+    transform: (input, payload) => {
       let data = input;
       if (params.case !== "sensitive")
         data = data.toLowerCase();
@@ -36807,14 +36818,14 @@ function _stringbool(Classes, _params) {
         });
         return {};
       }
-    }),
-    reverseTransform: ((input, _payload) => {
+    },
+    reverseTransform: (input, _payload) => {
       if (input === true) {
         return truthyArray[0] || "true";
       } else {
         return falsyArray[0] || "false";
       }
-    }),
+    },
     error: params.error
   });
   return codec2;
@@ -38142,10 +38153,10 @@ var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   inst.with = inst.check;
   inst.clone = (def2, params) => clone(inst, def2, params);
   inst.brand = () => inst;
-  inst.register = ((reg, meta3) => {
+  inst.register = (reg, meta3) => {
     reg.add(inst, meta3);
     return inst;
-  });
+  };
   inst.parse = (data, params) => parse2(inst, data, params, { callee: inst.parse });
   inst.safeParse = (data, params) => safeParse2(inst, data, params);
   inst.parseAsync = async (data, params) => parseAsync2(inst, data, params, { callee: inst.parseAsync });
@@ -39771,6 +39782,9 @@ var envSchema = external_exports.object({
   LLM_ENCRYPTION_KEY: external_exports.string().default(""),
   // Learning system
   BELIEF_HMAC_KEY: external_exports.string().default(""),
+  BELIEF_DISCOUNT_FACTOR: external_exports.coerce.number().min(0).max(1).default(0.995),
+  // Cold-start maturity threshold (number of trades before a trader is "established")
+  COLD_START_MATURITY_THRESHOLD: external_exports.coerce.number().int().nonnegative().default(50),
   // Feature flags
   ENABLE_LLM: external_exports.enum(["true", "false"]).default("false").transform((v) => v === "true"),
   ENABLE_LEARNING: external_exports.enum(["true", "false"]).default("false").transform((v) => v === "true"),
@@ -47031,8 +47045,9 @@ async function loadCredentials() {
   };
 }
 async function clearCredentials() {
-  await deleteFromKeychain();
+  const keychainCleared = await deleteFromKeychain();
   deleteCredentialsFile();
+  return { keychainCleared };
 }
 function redactApiKey(key) {
   if (key.length <= 12)
@@ -48205,6 +48220,9 @@ function registerTraderCommand(program2) {
       } else {
         console.log(formatTraderOutput(result));
         console.log(source_default.green("  Trader registered successfully."));
+        if (result.alias) {
+          console.log(`  ${source_default.gray("Leaderboard alias:")} ${source_default.white(result.alias)} ${source_default.dim("(change with: trading-boy trader set-alias <name> <alias>)")}`);
+        }
         console.log("");
         console.log(source_default.bold("  Next: Set up your trading identity"));
         console.log(source_default.dim("  SOUL and PURPOSE documents personalize your context \u2014 bias warnings,"));
@@ -48289,6 +48307,57 @@ function registerTraderCommand(program2) {
       process.exitCode = error49 instanceof ApiError ? 2 : 1;
     }
   });
+  const ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
+  trader.command("set-alias").description("Set a public leaderboard alias").argument("<name-or-id>", "Trader name or ID").argument("<alias>", "Leaderboard alias (3-30 chars, alphanumeric/underscores/hyphens)").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, alias, options) => {
+    const jsonMode = options.format === "json";
+    if (!ALIAS_PATTERN.test(alias)) {
+      const msg = "Invalid alias. Must be 3-30 characters, alphanumeric with underscores and hyphens.";
+      if (jsonMode) {
+        console.error(JSON.stringify({ error: msg }));
+      } else {
+        console.error(source_default.red(`  ${msg}`));
+      }
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/alias`, { method: "PUT", body: { alias } });
+      if (jsonMode) {
+        console.log(JSON.stringify({ alias, updated: true }));
+      } else {
+        console.log("");
+        console.log(source_default.green(`  Alias updated to: ${source_default.white(alias)}`));
+        console.log("");
+      }
+    } catch (error49) {
+      if (error49 instanceof ApiError && error49.status === 409) {
+        const msg = "Alias already taken. Try a different name.";
+        if (jsonMode) {
+          console.error(JSON.stringify({ error: msg }));
+        } else {
+          console.error(source_default.yellow(`  ${msg}`));
+        }
+        process.exitCode = 2;
+      } else if (error49 instanceof ApiError && error49.status === 404) {
+        const msg = `Trader not found: "${nameOrId}"`;
+        if (jsonMode) {
+          console.error(JSON.stringify({ error: msg }));
+        } else {
+          console.error(source_default.yellow(msg));
+        }
+        process.exitCode = 2;
+      } else {
+        const message = error49 instanceof Error ? error49.message : String(error49);
+        logger12.error({ error: message }, "Failed to set alias");
+        if (jsonMode) {
+          console.error(JSON.stringify({ error: message }));
+        } else {
+          console.error(source_default.red(`Error: ${message}`));
+        }
+        process.exitCode = error49 instanceof ApiError ? 2 : 1;
+      }
+    }
+  });
   trader.command("preferences").description("Update notification preferences").option("--summary-time <hour>", "Hour (0-23 UTC) to receive daily email summary", parseInt).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (options) => {
     if (options.summaryTime === void 0) {
       console.error(source_default.yellow("No updates provided. Use --summary-time <hour>."));
@@ -50222,17 +50291,44 @@ async function executeLogout() {
   const existing = await loadCredentials();
   const wasAuthenticated = existing !== null;
   const redactedKey = existing ? redactApiKey(existing.apiKey) : void 0;
-  await clearCredentials();
-  return { wasAuthenticated, redactedKey };
+  const { keychainCleared } = await clearCredentials();
+  return { wasAuthenticated, redactedKey, keychainCleared };
 }
 function registerLogoutCommand(program2) {
-  program2.command("logout").description("Clear stored API key and credentials").action(async () => {
+  program2.command("logout").description("Clear stored API key and credentials").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).addOption(new Option("--force", "Skip confirmation prompt")).addOption(new Option("--reveal-key", "Include full API key in JSON output (requires --force --format json)")).action(async (options) => {
     try {
+      const jsonMode = options.format === "json";
       const existing = await loadCredentials();
       if (!existing) {
-        console.log("");
-        console.log(source_default.dim("  No credentials found \u2014 already logged out."));
-        console.log("");
+        if (jsonMode) {
+          console.log(JSON.stringify({ loggedOut: false, reason: "no credentials" }));
+        } else {
+          console.log("");
+          console.log(source_default.dim("  No credentials found \u2014 already logged out."));
+          console.log("");
+        }
+        return;
+      }
+      if (jsonMode && !options.force) {
+        console.error(JSON.stringify({ error: "--force is required with --format json" }));
+        process.exitCode = 1;
+        return;
+      }
+      if (jsonMode) {
+        const fullKey = existing.apiKey;
+        const storageMethod2 = existing.storageMethod;
+        const result2 = await executeLogout();
+        const output = {
+          loggedOut: true,
+          redactedKey: result2.redactedKey
+        };
+        if (options.revealKey) {
+          output.apiKey = fullKey;
+        }
+        if (!result2.keychainCleared && storageMethod2 === "keychain") {
+          output.keychainWarning = "Could not remove key from OS keychain. You may need to manually remove the 'trading-boy' entry from your keychain.";
+        }
+        console.log(JSON.stringify(output));
         return;
       }
       console.log("");
@@ -50240,20 +50336,39 @@ function registerLogoutCommand(program2) {
       console.log(source_default.yellow("  You will need your API key to log back in."));
       console.log(source_default.yellow("  There is no way to recover a lost key \u2014 a new one must be provisioned."));
       console.log("");
-      const proceed = await esm_default4({ message: "Are you sure you want to logout?" });
+      const proceed = options.force || await esm_default4({ message: "Are you sure you want to logout?" });
       if (!proceed) {
         console.log(source_default.dim("  Logout cancelled."));
         return;
       }
+      const revealKey = await esm_default4({
+        message: "Would you like to see your full API key before it's deleted? (This is your last chance to copy it)"
+      });
+      if (revealKey) {
+        console.log("");
+        console.log(source_default.cyan("  Your API key:"));
+        console.log(`  ${source_default.bold(existing.apiKey)}`);
+        console.log("");
+      }
+      const storageMethod = existing.storageMethod;
       const result = await executeLogout();
       console.log("");
       console.log(source_default.green(`  Logged out successfully.`));
       console.log(`  ${source_default.gray("Cleared key:")} ${result.redactedKey}`);
+      if (!result.keychainCleared && storageMethod === "keychain") {
+        console.log("");
+        console.log(source_default.yellow("  Warning: Could not remove key from OS keychain."));
+        console.log(source_default.yellow("  You may need to manually remove the 'trading-boy' entry from your keychain."));
+      }
       console.log("");
     } catch (error49) {
       const message = error49 instanceof Error ? error49.message : String(error49);
       logger20.error({ error: message }, "Logout failed");
-      console.error(source_default.red(`  Error: ${message}`));
+      if (options.format === "json") {
+        console.error(JSON.stringify({ error: message }));
+      } else {
+        console.error(source_default.red(`  Error: ${message}`));
+      }
       process.exitCode = 1;
     }
   });

package/dist/commands/logout.d.ts

@@ -2,6 +2,7 @@ import { Command } from 'commander';
 export declare function executeLogout(): Promise<{
     wasAuthenticated: boolean;
     redactedKey?: string;
+    keychainCleared: boolean;
 }>;
 export declare function registerLogoutCommand(program: Command): void;
 //# sourceMappingURL=logout.d.ts.map

package/dist/commands/logout.js

@@ -1,3 +1,4 @@
+import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
 import { clearCredentials, loadCredentials, redactApiKey } from '../credentials.js';
@@ -8,43 +9,98 @@ export async function executeLogout() {
     const existing = await loadCredentials();
     const wasAuthenticated = existing !== null;
     const redactedKey = existing ? redactApiKey(existing.apiKey) : undefined;
-    await clearCredentials();
-    return { wasAuthenticated, redactedKey };
+    const { keychainCleared } = await clearCredentials();
+    return { wasAuthenticated, redactedKey, keychainCleared };
 }
 // ─── Command Registration ───
 export function registerLogoutCommand(program) {
     program
         .command('logout')
         .description('Clear stored API key and credentials')
-        .action(async () => {
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .addOption(new Option('--force', 'Skip confirmation prompt'))
+        .addOption(new Option('--reveal-key', 'Include full API key in JSON output (requires --force --format json)'))
+        .action(async (options) => {
         try {
+            const jsonMode = options.format === 'json';
             const existing = await loadCredentials();
             if (!existing) {
-                console.log('');
-                console.log(chalk.dim('  No credentials found — already logged out.'));
-                console.log('');
+                if (jsonMode) {
+                    console.log(JSON.stringify({ loggedOut: false, reason: 'no credentials' }));
+                }
+                else {
+                    console.log('');
+                    console.log(chalk.dim('  No credentials found — already logged out.'));
+                    console.log('');
+                }
+                return;
+            }
+            // JSON mode requires --force to skip interactive prompts
+            if (jsonMode && !options.force) {
+                console.error(JSON.stringify({ error: '--force is required with --format json' }));
+                process.exitCode = 1;
                 return;
             }
+            if (jsonMode) {
+                // Non-interactive JSON path
+                const fullKey = existing.apiKey;
+                const storageMethod = existing.storageMethod;
+                const result = await executeLogout();
+                const output = {
+                    loggedOut: true,
+                    redactedKey: result.redactedKey,
+                };
+                if (options.revealKey) {
+                    output.apiKey = fullKey;
+                }
+                if (!result.keychainCleared && storageMethod === 'keychain') {
+                    output.keychainWarning = 'Could not remove key from OS keychain. You may need to manually remove the \'trading-boy\' entry from your keychain.';
+                }
+                console.log(JSON.stringify(output));
+                return;
+            }
+            // Interactive text path
             console.log('');
             console.log(chalk.yellow('  Warning: Your API key will be cleared from this machine.'));
             console.log(chalk.yellow('  You will need your API key to log back in.'));
             console.log(chalk.yellow('  There is no way to recover a lost key — a new one must be provisioned.'));
             console.log('');
-            const proceed = await confirm({ message: 'Are you sure you want to logout?' });
+            const proceed = options.force || await confirm({ message: 'Are you sure you want to logout?' });
             if (!proceed) {
                 console.log(chalk.dim('  Logout cancelled.'));
                 return;
             }
+            // Offer to reveal the full key before deletion
+            const revealKey = await confirm({
+                message: 'Would you like to see your full API key before it\'s deleted? (This is your last chance to copy it)',
+            });
+            if (revealKey) {
+                console.log('');
+                console.log(chalk.cyan('  Your API key:'));
+                console.log(`  ${chalk.bold(existing.apiKey)}`);
+                console.log('');
+            }
+            const storageMethod = existing.storageMethod;
             const result = await executeLogout();
             console.log('');
             console.log(chalk.green(`  Logged out successfully.`));
             console.log(`  ${chalk.gray('Cleared key:')} ${result.redactedKey}`);
+            if (!result.keychainCleared && storageMethod === 'keychain') {
+                console.log('');
+                console.log(chalk.yellow('  Warning: Could not remove key from OS keychain.'));
+                console.log(chalk.yellow('  You may need to manually remove the \'trading-boy\' entry from your keychain.'));
+            }
             console.log('');
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             logger.error({ error: message }, 'Logout failed');
-            console.error(chalk.red(`  Error: ${message}`));
+            if (options.format === 'json') {
+                console.error(JSON.stringify({ error: message }));
+            }
+            else {
+                console.error(chalk.red(`  Error: ${message}`));
+            }
             process.exitCode = 1;
         }
     });

package/dist/commands/trader.d.ts

@@ -2,6 +2,7 @@ import { Command } from 'commander';
 interface TraderRecord {
     id: string;
     name: string;
+    alias?: string;
     maxDrawdownPct?: number;
     riskToleranceMax?: number;
     walletAddresses?: string[];

package/dist/commands/trader.js

@@ -111,6 +111,9 @@ export function registerTraderCommand(program) {
             else {
                 console.log(formatTraderOutput(result));
                 console.log(chalk.green('  Trader registered successfully.'));
+                if (result.alias) {
+                    console.log(`  ${chalk.gray('Leaderboard alias:')} ${chalk.white(result.alias)} ${chalk.dim('(change with: trading-boy trader set-alias <name> <alias>)')}`);
+                }
                 console.log('');
                 console.log(chalk.bold('  Next: Set up your trading identity'));
                 console.log(chalk.dim('  SOUL and PURPOSE documents personalize your context — bias warnings,'));
@@ -223,6 +226,72 @@ export function registerTraderCommand(program) {
             process.exitCode = error instanceof ApiError ? 2 : 1;
         }
     });
+    // ─── set-alias ───
+    const ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
+    trader
+        .command('set-alias')
+        .description('Set a public leaderboard alias')
+        .argument('<name-or-id>', 'Trader name or ID')
+        .argument('<alias>', 'Leaderboard alias (3-30 chars, alphanumeric/underscores/hyphens)')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (nameOrId, alias, options) => {
+        const jsonMode = options.format === 'json';
+        if (!ALIAS_PATTERN.test(alias)) {
+            const msg = 'Invalid alias. Must be 3-30 characters, alphanumeric with underscores and hyphens.';
+            if (jsonMode) {
+                console.error(JSON.stringify({ error: msg }));
+            }
+            else {
+                console.error(chalk.red(`  ${msg}`));
+            }
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/alias`, { method: 'PUT', body: { alias } });
+            if (jsonMode) {
+                console.log(JSON.stringify({ alias, updated: true }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.green(`  Alias updated to: ${chalk.white(alias)}`));
+                console.log('');
+            }
+        }
+        catch (error) {
+            if (error instanceof ApiError && error.status === 409) {
+                const msg = 'Alias already taken. Try a different name.';
+                if (jsonMode) {
+                    console.error(JSON.stringify({ error: msg }));
+                }
+                else {
+                    console.error(chalk.yellow(`  ${msg}`));
+                }
+                process.exitCode = 2;
+            }
+            else if (error instanceof ApiError && error.status === 404) {
+                const msg = `Trader not found: "${nameOrId}"`;
+                if (jsonMode) {
+                    console.error(JSON.stringify({ error: msg }));
+                }
+                else {
+                    console.error(chalk.yellow(msg));
+                }
+                process.exitCode = 2;
+            }
+            else {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error({ error: message }, 'Failed to set alias');
+                if (jsonMode) {
+                    console.error(JSON.stringify({ error: message }));
+                }
+                else {
+                    console.error(chalk.red(`Error: ${message}`));
+                }
+                process.exitCode = error instanceof ApiError ? 2 : 1;
+            }
+        }
+    });
     // ─── preferences ───
     trader
         .command('preferences')

package/dist/credentials.d.ts

@@ -12,7 +12,9 @@ export declare function storeCredentials(apiKey: string, metadata?: {
     plan?: string;
 }): Promise<void>;
 export declare function loadCredentials(): Promise<StoredCredentials | null>;
-export declare function clearCredentials(): Promise<void>;
+export declare function clearCredentials(): Promise<{
+    keychainCleared: boolean;
+}>;
 export declare function redactApiKey(key: string): string;
 export declare function getCredentialsFilePath(): string;
 //# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.js

@@ -151,8 +151,9 @@ export async function loadCredentials() {
     };
 }
 export async function clearCredentials() {
-    await deleteFromKeychain();
+    const keychainCleared = await deleteFromKeychain();
     deleteCredentialsFile();
+    return { keychainCleared };
 }
 export function redactApiKey(key) {
     if (key.length <= 12)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trading-boy/cli",
-  "version": "1.2.16",
+  "version": "1.2.17",
   "description": "Trading Boy CLI — crypto context intelligence for traders and AI agents. Query real-time prices, funding rates, whale activity, and DeFi risk for 100+ Solana tokens and 229 Hyperliquid perpetuals.",
   "homepage": "https://cabal.ventures",
   "repository": {