@trucore/atf 1.4.3 → 1.5.1

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 "use strict";
 
-// @trucore/atf v1.4.3 — Agent Transaction Firewall CLI
-// Built: 2026-04-04T17:33:07.167Z
-// Commit: 034a42d
+// @trucore/atf v1.5.1 — Agent Transaction Firewall CLI
+// Built: 2026-04-05T01:48:06.696Z
+// Commit: bfa266c
 
 // ---- src/constants.mjs ----
 /**
@@ -13,10 +13,10 @@
  * by build.mjs during the bundling step.
  */
 
-const VERSION = "1.4.3";
+const VERSION = "1.5.1";
 const DEFAULT_BASE_URL = "https://api.trucore.xyz";
-const BUILD_COMMIT = "034a42d";
-const BUILD_DATE = "2026-04-04T17:33:07.167Z";
+const BUILD_COMMIT = "bfa266c";
+const BUILD_DATE = "2026-04-05T01:48:06.696Z";
 const SIMULATE_PATHS = ["/api/simulate", "/v1/simulate"];
 
 // ---- src/redact.mjs ----
@@ -1071,9 +1071,16 @@ async function runProfileCreate(args) {
   if (config.profiles[name]) {
     exitWithError(ERROR_CODES.USER_ERROR, `Profile "${name}" already exists.`, null, args.format);
   }
-  config.profiles[name] = { ...PROFILE_DEFAULTS, tx: { ...PROFILE_DEFAULTS.tx } };
+  const profile = { ...PROFILE_DEFAULTS, tx: { ...PROFILE_DEFAULTS.tx } };
+  // --network flag sets solana_cluster (e.g. --network devnet)
+  if (args.network) {
+    profile.solana_cluster = args.network;
+  }
+  config.profiles[name] = profile;
   saveGlobalConfig(config);
-  process.stdout.write(JSON.stringify({ ok: true, created: name }, null, 2) + "\n");
+  const result = { ok: true, created: name };
+  if (args.network) result.solana_cluster = args.network;
+  process.stdout.write(JSON.stringify(result, null, 2) + "\n");
 }
 
 async function runProfileDelete(args) {
@@ -1209,6 +1216,72 @@ async function runProfileWizard(args) {
   }
 }
 
+/**
+ * runBurnerCommand — top-level "atf burner" handler.
+ *
+ * Subcommands:
+ *   enable       Set the active profile's solana_cluster to devnet (burner mode).
+ *
+ * Standalone (no subcommand):
+ *   atf burner --network devnet   Same as enable — sets cluster and confirms.
+ *
+ * This bridges the documented site quickstart (atf burner enable,
+ * atf burner --network devnet) to the underlying profile/config system.
+ */
+async function runBurnerCommand(args) {
+  const format = args.format;
+  const sub = args.subCommand;
+  const network = args.network || "devnet";
+
+  if (network !== "devnet") {
+    exitWithError(
+      ERROR_CODES.USER_ERROR,
+      `Burner mode only supports devnet. Got: ${network}`,
+      "Usage: atf burner enable  OR  atf burner --network devnet",
+      format,
+    );
+  }
+
+  if (sub && sub !== "enable") {
+    exitWithError(
+      ERROR_CODES.USER_ERROR,
+      `Unknown burner subcommand: ${sub}`,
+      "Available: enable\nUsage: atf burner enable  OR  atf burner --network devnet",
+      format,
+    );
+  }
+
+  // Load or initialize global config
+  const config = loadGlobalConfig();
+  const profileName = args.profileFlag || config.current_profile || "default";
+
+  if (!config.profiles[profileName]) {
+    // Auto-create the profile if it doesn't exist yet
+    config.profiles[profileName] = { ...PROFILE_DEFAULTS, tx: { ...PROFILE_DEFAULTS.tx } };
+  }
+
+  config.profiles[profileName].solana_cluster = "devnet";
+  saveGlobalConfig(config);
+
+  const result = {
+    ok: true,
+    burner_enabled: true,
+    profile: profileName,
+    solana_cluster: "devnet",
+    message: `Burner mode enabled on profile "${profileName}" (cluster: devnet).`,
+  };
+
+  if (format === "pretty") {
+    const noColor = args.noColor || !!process.env.NO_COLOR;
+    const c = noColor
+      ? { reset: "", bold: "", green: "", dim: "" }
+      : { reset: "\x1b[0m", bold: "\x1b[1m", green: "\x1b[32m", dim: "\x1b[2m" };
+    process.stdout.write(`\n${c.green}🔥${c.reset} ${result.message}\n\n`);
+  } else {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  }
+}
+
 // ---- src/secret_store.mjs ----
 /**
  * secret_store.mjs — file-based secret store with permission hardening
@@ -18525,10 +18598,13 @@ CONFIG & PROFILES
   config get          Get a profile config key
   config list         Show effective merged config (secrets redacted)
   profile use         Switch active profile
+  profile select      Alias for profile use
   profile list        List all profiles
-  profile create      Create a new profile
+  profile create      Create a new profile (supports --network devnet|mainnet)
   profile delete      Delete a profile
   profile wizard      Interactive guided profile setup
+  burner enable       Enable devnet burner mode on the active profile
+  burner [--network]  Standalone burner setup (devnet ephemeral wallet)
   secret set          Store a secret (e.g. Helius API key)
   secret list         List stored secret references (no values)
   secret unset        Remove a stored secret
@@ -18838,14 +18914,20 @@ Usage:
 
 Subcommands:
   use       Switch active profile
+  select    Alias for use
   list      List all profiles
   create    Create a new profile
   delete    Delete a profile
   wizard    Interactive guided profile setup
 
+Options:
+  --network <name>  Set solana_cluster on create (devnet or mainnet)
+
 Examples:
   atf profile create devnet
+  atf profile create devnet-burner --network devnet
   atf profile use devnet
+  atf profile select devnet
   atf profile list
   atf profile wizard
 `,
@@ -18864,6 +18946,25 @@ Examples:
   atf secret set HELIUS_API_KEY
   atf secret list
   atf secret unset HELIUS_API_KEY
+`,
+  burner: `
+ATF BURNER — Devnet Burner Mode
+
+  Manage ephemeral devnet wallet for safe testing.
+  Sets the active profile to devnet cluster and generates a throwaway keypair.
+
+Usage:
+  atf burner [subcommand] [options]
+
+Subcommands:
+  enable    Enable burner mode on the active profile (set cluster to devnet)
+
+Options:
+  --network <name>   Target network (default: devnet). Only devnet is supported.
+
+Examples:
+  atf burner enable
+  atf burner --network devnet
 `,
   bot: `
 ATF BOT — Bot / Agent Commands
@@ -19351,6 +19452,7 @@ function parseArgs(argv) {
     confirm: false,
     confirmTimeoutMs: 60_000,
     // burner / devnet flags
+    network: null,
     burner: false,
     devnet: false,
     faucet: false,
@@ -19412,7 +19514,7 @@ function parseArgs(argv) {
   const raw = argv.slice(2);
   let i = 0;
   // Commands that accept subcommands
-  const MULTI_COMMANDS = new Set(["config", "profile", "secret", "rpc", "tx", "receipts", "completion", "policy", "fixtures", "lint", "plan", "bot", "perps", "report", "demo", "verify"]);
+  const MULTI_COMMANDS = new Set(["config", "profile", "secret", "rpc", "tx", "receipts", "completion", "policy", "fixtures", "lint", "plan", "bot", "perps", "report", "demo", "verify", "burner"]);
 
   while (i < raw.length) {
     const arg = raw[i];
@@ -19501,6 +19603,9 @@ function parseArgs(argv) {
     } else if (arg === "--burner") {
       args.burner = true;
       i++;
+    } else if (arg === "--network") {
+      args.network = raw[++i] || null;
+      i++;
     } else if (arg === "--devnet") {
       args.devnet = true;
       i++;
@@ -19725,6 +19830,7 @@ async function main() {
     case "profile":
       switch (args.subCommand) {
         case "use":
+        case "select":
           await runProfileUse(args);
           break;
         case "list":
@@ -19740,7 +19846,7 @@ async function main() {
           await runProfileWizard(args);
           break;
         default:
-          exitWithError(ERROR_CODES.USER_ERROR, `Unknown profile subcommand: ${args.subCommand || "(none)"}`, "Available: use, list, create, delete, wizard", args.format);
+          exitWithError(ERROR_CODES.USER_ERROR, `Unknown profile subcommand: ${args.subCommand || "(none)"}`, "Available: use, select, list, create, delete, wizard", args.format);
       }
       break;
     case "secret":
@@ -19916,6 +20022,9 @@ async function main() {
     case "bootstrap":
       await runBootstrap(args);
       break;
+    case "burner":
+      await runBurnerCommand(args);
+      break;
     case "report":
       switch (args.subCommand) {
         case "savings":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trucore/atf",
-  "version": "1.4.3",
+  "version": "1.5.1",
   "description": "Agent Transaction Firewall CLI — simulate, verify, and audit on-chain transactions trustlessly.",
   "license": "MIT",
   "repository": {