@mailmodo/cli 0.0.7 → 0.0.8-beta.pr10.14

package/bin/dev.js

@@ -1,20 +1,26 @@
 #!/usr/bin/env node
 
-import {spawnSync} from 'node:child_process'
-import {fileURLToPath} from 'node:url'
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
 
-import {execute} from '@oclif/core'
+import { execute } from '@oclif/core';
 
 if (process.env.MAILMODO_DEV_TSX) {
-  await execute({development: true, dir: import.meta.url})
+  await execute({ development: true, dir: import.meta.url });
 } else {
-  const scriptPath = fileURLToPath(import.meta.url)
-  const result = spawnSync(process.execPath, ['--import', 'tsx', scriptPath, ...process.argv.slice(2)], {
-    env: {...process.env, MAILMODO_DEV_TSX: '1'},
-    stdio: 'inherit',
-  })
+  const scriptPath = fileURLToPath(import.meta.url);
+  const result = spawnSync(
+    process.execPath,
+    ['--import', 'tsx', scriptPath, ...process.argv.slice(2)],
+    {
+      env: { ...process.env, MAILMODO_DEV_TSX: '1' },
+      stdio: 'inherit',
+    }
+  );
 
   if (result.status !== 0) {
-    throw new Error(`dev bootstrap failed with exit code ${result.status ?? 1}`)
+    throw new Error(
+      `dev bootstrap failed with exit code ${result.status ?? 1}`
+    );
   }
 }

package/bin/run.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-import {execute} from '@oclif/core'
+import { execute } from '@oclif/core';
 
-await execute({dir: import.meta.url})
+await execute({ dir: import.meta.url });

package/dist/commands/billing/index.js

@@ -12,8 +12,13 @@ export default class Billing extends BaseCommand {
     ];
     static flags = {
         ...BaseCommand.baseFlags,
-        cap: Flags.integer({ description: 'Set monthly block cap (max blocks to auto-charge)' }),
-        status: Flags.boolean({ default: false, description: 'Show billing status only' }),
+        cap: Flags.integer({
+            description: 'Set monthly block cap (max blocks to auto-charge)',
+        }),
+        status: Flags.boolean({
+            default: false,
+            description: 'Show billing status only',
+        }),
     };
     async run() {
         const { flags } = await this.parse(Billing);
@@ -79,7 +84,9 @@ export default class Billing extends BaseCommand {
      * @param {boolean} jsonOutput - Whether to output JSON instead of formatted text.
      */
     async setCap(cap, jsonOutput) {
-        const response = await this.apiClient.patch(API_ENDPOINTS.BILLING_CAP, { cap });
+        const response = await this.apiClient.patch(API_ENDPOINTS.BILLING_CAP, {
+            cap,
+        });
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/contacts/index.js

@@ -13,8 +13,13 @@ export default class Contacts extends BaseCommand {
     ];
     static flags = {
         ...BaseCommand.baseFlags,
-        delete: Flags.string({ description: 'GDPR hard delete a contact by email' }),
-        export: Flags.boolean({ default: false, description: 'Export all contacts as CSV' }),
+        delete: Flags.string({
+            description: 'GDPR hard delete a contact by email',
+        }),
+        export: Flags.boolean({
+            default: false,
+            description: 'Export all contacts as CSV',
+        }),
         search: Flags.string({ description: 'Search for a contact by email' }),
     };
     async run() {

package/dist/commands/deploy/index.js

@@ -28,7 +28,10 @@ export default class Deploy extends BaseCommand {
                 this.log(`  This is a one-time setup. Takes about 5 minutes.\n`);
             }
             if (!flags.yes) {
-                const setupNow = await confirm({ default: true, message: 'Set up your sending domain now?' });
+                const setupNow = await confirm({
+                    default: true,
+                    message: 'Set up your sending domain now?',
+                });
                 if (!setupNow) {
                     this.log(`\n  Sequences saved but ${chalk.yellow('NOT deployed')}.`);
                     this.log(`  Emails will not send until your domain is verified.`);
@@ -83,7 +86,7 @@ export default class Deploy extends BaseCommand {
         this.log(`  ${chalk.dim('// On user signup:')}`);
         this.log(`  ${chalk.dim("track('user.signup', { email, first_name, app_url })")}\n`);
         this.log(`  ${chalk.dim('// When user creates a project:')}`);
-        this.log(`  ${chalk.dim("identify(email, { has_created_project: true })")}\n`);
+        this.log(`  ${chalk.dim('identify(email, { has_created_project: true })')}\n`);
         this.log(`  ${chalk.dim('// On trial expiry:')}`);
         this.log(`  ${chalk.dim("track('user.trial_expiry', { email, first_name })")}\n`);
         this.log(`  Full SDK docs: ${chalk.cyan('mailmodo.com/docs/sdk')}\n`);
@@ -115,7 +118,7 @@ export default class Deploy extends BaseCommand {
             });
             senderEmail = await input({
                 message: 'Sender email address:',
-                validate: (v) => (v?.includes('@') ? true : 'Please enter a valid email'),
+                validate: (v) => v?.includes('@') ? true : 'Please enter a valid email',
             });
             address = await input({
                 message: 'Business address (required by law for email footers):',

package/dist/commands/domain/index.js

@@ -13,8 +13,14 @@ export default class Domain extends BaseCommand {
     ];
     static flags = {
         ...BaseCommand.baseFlags,
-        status: Flags.boolean({ default: false, description: 'Show domain health status' }),
-        verify: Flags.boolean({ default: false, description: 'Verify DNS records' }),
+        status: Flags.boolean({
+            default: false,
+            description: 'Show domain health status',
+        }),
+        verify: Flags.boolean({
+            default: false,
+            description: 'Verify DNS records',
+        }),
     };
     async run() {
         const { flags } = await this.parse(Domain);
@@ -58,7 +64,7 @@ export default class Domain extends BaseCommand {
             senderEmail = await input({
                 default: yamlConfig.project?.fromEmail,
                 message: 'Sender email address:',
-                validate: (v) => (v?.includes('@') ? true : 'Please enter a valid email'),
+                validate: (v) => v?.includes('@') ? true : 'Please enter a valid email',
             });
             address = await input({
                 default: yamlConfig.project?.address,

package/dist/commands/edit/index.js

@@ -3,7 +3,7 @@ import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
-import { loadTemplate, saveTemplate, saveYaml } from '../../lib/yaml-config.js';
+import { loadTemplate, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 export default class Edit extends BaseCommand {
     static args = {
         id: Args.string({ description: 'Email ID to edit', required: true }),
@@ -15,7 +15,9 @@ export default class Edit extends BaseCommand {
     ];
     static flags = {
         ...BaseCommand.baseFlags,
-        change: Flags.string({ description: 'Natural language description of the change' }),
+        change: Flags.string({
+            description: 'Natural language description of the change',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Edit);
@@ -34,7 +36,7 @@ export default class Edit extends BaseCommand {
         if (!changeDescription) {
             changeDescription = await input({
                 message: 'What do you want to change?',
-                validate: (value) => (value?.trim() ? true : 'Please describe the change'),
+                validate: (value) => value?.trim() ? true : 'Please describe the change',
             });
         }
         const response = await this.apiClient.post(API_ENDPOINTS.EDIT, {
@@ -61,7 +63,10 @@ export default class Edit extends BaseCommand {
             this.log(`  ${chalk.green(`+ ${newSubject}`)}`);
         }
         if (!flags.yes) {
-            const accepted = await confirm({ default: true, message: 'Accept changes?' });
+            const accepted = await confirm({
+                default: true,
+                message: 'Accept changes?',
+            });
             if (!accepted) {
                 this.log('\n  Changes discarded.\n');
                 return;
@@ -83,7 +88,9 @@ export default class Edit extends BaseCommand {
         if (flags.json) {
             this.log(JSON.stringify({
                 diff: {
-                    subject: oldSubject === newSubject ? undefined : { new: newSubject, old: oldSubject },
+                    subject: oldSubject === newSubject
+                        ? undefined
+                        : { new: newSubject, old: oldSubject },
                 },
                 email,
                 status: 'updated',

package/dist/commands/emails/index.js

@@ -25,7 +25,9 @@ export default class Emails extends BaseCommand {
             const id = email.id.padEnd(maxIdLen + 2);
             const trigger = `trigger: ${email.trigger}`.padEnd(maxTriggerLen + 12);
             const delay = `delay: ${email.delay}`;
-            const condition = email.condition ? chalk.dim(` [if ${email.condition}]`) : '';
+            const condition = email.condition
+                ? chalk.dim(` [if ${email.condition}]`)
+                : '';
             this.log(`  ${chalk.cyan(id)} ${trigger} ${delay}${condition}`);
         }
         this.log('');

package/dist/commands/init/index.js

@@ -1,9 +1,9 @@
 import { Flags } from '@oclif/core';
-import { confirm, input } from '@inquirer/prompts';
+import { editor, input, select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
-import { saveTemplate, saveYaml } from '../../lib/yaml-config.js';
+import { saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 function isValidUrl(value) {
     try {
         return Boolean(new URL(value));
@@ -55,20 +55,51 @@ export default class Init extends BaseCommand {
             }
             this.log('');
         }
+        let analysisPayload = analysis;
         if (!flags.yes) {
-            const ok = await confirm({ default: true, message: 'Does this look right?' });
-            if (!ok) {
-                this.log(`\n  Run ${chalk.cyan('mailmodo init')} again to re-analyze.\n`);
+            const userAction = await select({
+                choices: [
+                    { name: 'Yes - continue with this result', value: 'yes' },
+                    { name: 'No - stop here', value: 'no' },
+                    { name: 'Edit - update the result before continuing', value: 'edit' },
+                ],
+                message: 'Does this look right?',
+            });
+            if (userAction === 'no') {
+                this.log(`\n  Stopped. Run ${chalk.cyan('mailmodo init')} again when you are ready.\n`);
                 return;
             }
+            if (userAction === 'edit') {
+                const editedAnalysis = await editor({
+                    default: JSON.stringify(analysis, null, 2),
+                    message: 'Edit the analysis JSON. Save and close to continue.',
+                    postfix: '.json',
+                    validate(value) {
+                        if (!value?.trim())
+                            return 'Edited analysis cannot be empty';
+                        try {
+                            JSON.parse(value);
+                            return true;
+                        }
+                        catch {
+                            return 'Please provide valid JSON';
+                        }
+                    },
+                });
+                analysisPayload = JSON.parse(editedAnalysis);
+            }
         }
+        this.log('analysisPayload', analysisPayload);
         this.log('\n  Generating emails...\n');
-        const generateResponse = await this.apiClient.post(API_ENDPOINTS.GENERATE, { analysis, productUrl });
+        const generateResponse = await this.apiClient.post(API_ENDPOINTS.GENERATE, {
+            analysis: analysisPayload,
+            productUrl,
+        });
         if (!generateResponse.ok) {
             this.handleApiError(generateResponse);
         }
         const generatedEmails = generateResponse.data?.emails || [];
-        const emailConfigs = analysis.recommendedEmails.map((rec, index) => {
+        const emailConfigs = analysisPayload.recommendedEmails.map((rec, index) => {
             const generated = generatedEmails[index];
             return {
                 delay: rec.delay || '0',
@@ -77,27 +108,29 @@ export default class Init extends BaseCommand {
                 ...(rec.condition ? { condition: rec.condition } : {}),
                 subject: generated?.subject || `Email for ${rec.id}`,
                 template: `mailmodo/${rec.id}.html`,
-                ...(generated?.previewText ? { previewText: generated.previewText } : {}),
+                ...(generated?.previewText
+                    ? { previewText: generated.previewText }
+                    : {}),
                 goal: rec.goal,
             };
         });
         const yamlConfig = {
             emails: emailConfigs,
             project: {
-                brandColor: analysis.brand?.color || DEFAULT_BRAND_COLOR,
+                brandColor: analysisPayload.brand?.color || DEFAULT_BRAND_COLOR,
                 emailStyle: 'branded',
                 fromEmail: '',
-                fromName: `Team ${analysis.productName}`,
-                logoUrl: analysis.brand?.logoUrl || '',
-                name: analysis.productName,
+                fromName: `Team ${analysisPayload.productName}`,
+                logoUrl: analysisPayload.brand?.logoUrl || '',
+                name: analysisPayload.productName,
                 replyTo: '',
-                type: analysis.pricingModel,
+                type: analysisPayload.pricingModel,
                 url: productUrl,
                 webhookUrl: '',
             },
         };
         await saveYaml(yamlConfig);
-        const templateSaves = analysis.recommendedEmails.flatMap((rec, index) => {
+        const templateSaves = analysisPayload.recommendedEmails.flatMap((rec, index) => {
             const generated = generatedEmails[index];
             const saves = [];
             if (generated?.html) {
@@ -111,7 +144,7 @@ export default class Init extends BaseCommand {
         await Promise.all(templateSaves);
         if (flags.json) {
             this.log(JSON.stringify({
-                brandDetected: analysis.brand,
+                brandDetected: analysisPayload.brand,
                 emails: emailConfigs,
                 emailsCreated: emailConfigs.length,
                 style: yamlConfig.project.emailStyle,

package/dist/commands/login/index.js

@@ -34,15 +34,13 @@ export default class Login extends BaseCommand {
                 validate(value) {
                     if (!value?.trim())
                         return 'API key is required';
-                    if (!value.startsWith('mm_'))
-                        return 'Invalid API key format. Keys start with mm_';
                     return true;
                 },
             });
         }
         const trimmedKey = apiKey.trim();
         const client = new ApiClient(trimmedKey);
-        const response = await client.get(API_ENDPOINTS.AUTH_VALIDATE);
+        const response = await client.post(API_ENDPOINTS.AUTH_VALIDATE, {});
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/logs/index.js

@@ -13,7 +13,10 @@ export default class Logs extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         email: Flags.string({ description: 'Filter logs by contact email' }),
-        failed: Flags.boolean({ default: false, description: 'Show only failed/bounced events' }),
+        failed: Flags.boolean({
+            default: false,
+            description: 'Show only failed/bounced events',
+        }),
     };
     async run() {
         const { flags } = await this.parse(Logs);

package/dist/commands/preview/index.js

@@ -63,7 +63,10 @@ export default class Preview extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         send: Flags.string({ description: 'Send test email to this address' }),
-        text: Flags.boolean({ default: false, description: 'Output plain text version (for AI agents)' }),
+        text: Flags.boolean({
+            default: false,
+            description: 'Output plain text version (for AI agents)',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Preview);
@@ -97,7 +100,9 @@ export default class Preview extends BaseCommand {
      * and CI pipelines that cannot open a browser.
      */
     async renderText(email, templateHtml, sampleData, jsonOutput) {
-        const rendered = templateHtml ? renderTemplate(templateHtml, sampleData) : '';
+        const rendered = templateHtml
+            ? renderTemplate(templateHtml, sampleData)
+            : '';
         const plainText = htmlToText(rendered);
         if (jsonOutput) {
             this.log(JSON.stringify({
@@ -139,7 +144,9 @@ export default class Preview extends BaseCommand {
      * template, then opens the user's default browser to view it.
      */
     async startPreviewServer(email, templateHtml, sampleData, jsonOutput) {
-        const rendered = templateHtml ? renderTemplate(templateHtml, sampleData) : '<p>No template found.</p>';
+        const rendered = templateHtml
+            ? renderTemplate(templateHtml, sampleData)
+            : '<p>No template found.</p>';
         const wrapperHtml = `<!DOCTYPE html>
 <html>
 <head>

package/dist/commands/settings/index.js

@@ -50,7 +50,8 @@ export default class Settings extends BaseCommand {
             if (!(propKey in project)) {
                 this.error(`Unknown setting: ${key}`);
             }
-            project[propKey] = propKey === 'monthlyCap' ? Number(value) : value;
+            project[propKey] =
+                propKey === 'monthlyCap' ? Number(value) : value;
             await saveYaml(yamlConfig);
             if (flags.json) {
                 this.log(JSON.stringify({ [propKey]: value, status: 'updated' }, null, 2));

package/dist/lib/api-client.d.ts

@@ -1,26 +1,29 @@
+/**
+ * Request context attached to API responses for troubleshooting failed calls.
+ * Only the resolved URL is stored; it encodes origin, path, and query string.
+ */
+export interface ApiRequestDebugInfo {
+    /** Node/DNS/network error code when `fetch` throws before an HTTP response. */
+    causeCode?: string;
+    /** Fully resolved request URL (origin, path, and query string). */
+    fullUrl: string;
+    /** Truncated JSON summary of a non-empty error response body, when available. */
+    responseSummary?: string;
+}
 export interface ApiResponse<T = Record<string, unknown>> {
     data: T;
+    /** Populated for tracing; especially useful when `ok` is false. */
+    debug?: ApiRequestDebugInfo;
     error?: string;
     ok: boolean;
     status: number;
 }
-/**
- * HTTP client for the Mailmodo CLI API.
- * Wraps the native fetch API with Bearer token authentication,
- * consistent error handling, and typed responses.
- *
- * All requests include:
- * - Authorization header with the user's API key
- * - Content-Type: application/json
- * - User-Agent: @mailmodo/cli
- *
- * Network errors (ECONNREFUSED, ENOTFOUND) return a friendly message
- * indicating the API may not be available, rather than a raw stack trace.
- */
 export declare class ApiClient {
     private apiKey;
     private baseUrl;
     constructor(apiKey: string);
+    private resolveUrl;
+    private requestDebug;
     /**
      * Sends an HTTP request to the Mailmodo API and returns a typed response.
      *

package/dist/lib/api-client.js

@@ -12,6 +12,22 @@ import { API_BASE_URL } from './constants.js';
  * Network errors (ECONNREFUSED, ENOTFOUND) return a friendly message
  * indicating the API may not be available, rather than a raw stack trace.
  */
+const RESPONSE_BODY_DEBUG_MAX = 800;
+function summarizeResponseBody(data) {
+    if (data === null || data === undefined)
+        return undefined;
+    try {
+        const s = JSON.stringify(data);
+        if (s === '{}' || s === '[]')
+            return undefined;
+        return s.length > RESPONSE_BODY_DEBUG_MAX
+            ? `${s.slice(0, RESPONSE_BODY_DEBUG_MAX)}…`
+            : s;
+    }
+    catch {
+        return undefined;
+    }
+}
 export class ApiClient {
     apiKey;
     baseUrl;
@@ -19,6 +35,18 @@ export class ApiClient {
         this.baseUrl = API_BASE_URL;
         this.apiKey = apiKey;
     }
+    resolveUrl(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        return url;
+    }
+    requestDebug(url) {
+        return { fullUrl: url.toString() };
+    }
     /**
      * Sends an HTTP request to the Mailmodo API and returns a typed response.
      *
@@ -31,14 +59,10 @@ export class ApiClient {
      *   data (parsed JSON body), and optional error (string message on failure).
      */
     async request(method, path, body, params) {
-        const url = new URL(`${this.baseUrl}${path}`);
-        if (params) {
-            for (const [key, value] of Object.entries(params)) {
-                url.searchParams.set(key, value);
-            }
-        }
+        const url = this.resolveUrl(path, params);
+        const debug = this.requestDebug(url);
         const headers = {
-            'Authorization': `Bearer ${this.apiKey}`,
+            Authorization: `Bearer ${this.apiKey}`,
             'Content-Type': 'application/json',
             'User-Agent': '@mailmodo/cli',
         };
@@ -51,8 +75,13 @@ export class ApiClient {
             const data = await response.json().catch(() => ({}));
             if (!response.ok) {
                 const errorData = data;
+                const summary = summarizeResponseBody(data);
                 return {
                     data: data,
+                    debug: {
+                        ...debug,
+                        responseSummary: summary,
+                    },
                     error: errorData?.message ||
                         errorData?.error ||
                         `Request failed with status ${response.status}`,
@@ -65,11 +94,16 @@ export class ApiClient {
         catch (error) {
             const err = error;
             const isConnectionError = err?.cause?.code === 'ECONNREFUSED' || err?.cause?.code === 'ENOTFOUND';
+            const causeCode = err?.cause?.code;
             return {
                 data: {},
+                debug: {
+                    ...debug,
+                    ...(causeCode ? { causeCode } : {}),
+                },
                 error: isConnectionError
                     ? 'Cannot connect to Mailmodo API. The API service may not be available yet.'
-                    : (err?.message || 'An unexpected network error occurred.'),
+                    : err?.message || 'An unexpected network error occurred.',
                 ok: false,
                 status: 0,
             };
@@ -88,12 +122,13 @@ export class ApiClient {
         return this.request('POST', path, body);
     }
     async postFormData(path, formData) {
-        const url = new URL(`${this.baseUrl}${path}`);
+        const url = this.resolveUrl(path);
+        const debug = this.requestDebug(url);
         try {
             const response = await fetch(url.toString(), {
                 body: formData,
                 headers: {
-                    'Authorization': `Bearer ${this.apiKey}`,
+                    Authorization: `Bearer ${this.apiKey}`,
                     'User-Agent': '@mailmodo/cli',
                 },
                 method: 'POST',
@@ -101,8 +136,13 @@ export class ApiClient {
             const data = await response.json().catch(() => ({}));
             if (!response.ok) {
                 const errorData = data;
+                const summary = summarizeResponseBody(data);
                 return {
                     data: data,
+                    debug: {
+                        ...debug,
+                        responseSummary: summary,
+                    },
                     error: errorData?.message ||
                         errorData?.error ||
                         `Upload failed with status ${response.status}`,
@@ -114,8 +154,13 @@ export class ApiClient {
         }
         catch (error) {
             const err = error;
+            const causeCode = err?.cause?.code;
             return {
                 data: {},
+                debug: {
+                    ...debug,
+                    ...(causeCode ? { causeCode } : {}),
+                },
                 error: err?.message || 'File upload failed.',
                 ok: false,
                 status: 0,

package/dist/lib/base-command.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { ApiClient } from './api-client.js';
+import { ApiClient, type ApiRequestDebugInfo } from './api-client.js';
 import { type MailmodoConfig } from './config.js';
 import { type MailmodoYaml } from './yaml-config.js';
 /**
@@ -34,12 +34,24 @@ export declare abstract class BaseCommand extends Command {
      * Handles a failed API response by mapping HTTP status codes to
      * user-friendly error messages and exiting the process.
      *
-     * @param {{ status: number; error?: string }} response - The API response object with ok=false.
+     * @param {{ status: number; error?: string; debug?: ApiRequestDebugInfo }} response - The API response object with ok=false.
      *   Status 401 prompts re-authentication, 429 indicates rate limiting,
      *   all others display the server's error message or a generic fallback.
+     *   When `debug` is present, extra lines list Full URL, Status, optional Response
+     *   body summary, and optional Error Code (network failures).
      */
     protected handleApiError(response: {
+        debug?: ApiRequestDebugInfo;
         error?: string;
         status: number;
     }): never;
+    /**
+     * Builds the terminal error string for a failed API call, appending request
+     * metadata when {@link ApiRequestDebugInfo} is available.
+     *
+     * @param {string} message - Primary error text (HTTP message or generic).
+     * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
+     * @returns {string} Message plus indented Request details for troubleshooting.
+     */
+    private formatApiFailure;
 }

package/dist/lib/base-command.js

@@ -11,7 +11,11 @@ import { loadYaml } from './yaml-config.js';
 export class BaseCommand extends Command {
     static baseFlags = {
         json: Flags.boolean({ default: false, description: 'Output as JSON' }),
-        yes: Flags.boolean({ char: 'y', default: false, description: 'Skip confirmation prompts' }),
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Skip confirmation prompts',
+        }),
     };
     apiClient;
     /**
@@ -53,17 +57,48 @@ export class BaseCommand extends Command {
      * Handles a failed API response by mapping HTTP status codes to
      * user-friendly error messages and exiting the process.
      *
-     * @param {{ status: number; error?: string }} response - The API response object with ok=false.
+     * @param {{ status: number; error?: string; debug?: ApiRequestDebugInfo }} response - The API response object with ok=false.
      *   Status 401 prompts re-authentication, 429 indicates rate limiting,
      *   all others display the server's error message or a generic fallback.
+     *   When `debug` is present, extra lines list Full URL, Status, optional Response
+     *   body summary, and optional Error Code (network failures).
      */
     handleApiError(response) {
         if (response.status === 401) {
-            this.error(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`);
+            this.error(this.formatApiFailure(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`, response));
         }
         if (response.status === 429) {
-            this.error('Rate limit exceeded. Please try again later.');
+            this.error(this.formatApiFailure('Rate limit exceeded. Please try again later.', response));
         }
-        this.error(response.error || 'An unexpected API error occurred.');
+        this.error(this.formatApiFailure(response.error || 'An unexpected API error occurred.', response));
+    }
+    /**
+     * Builds the terminal error string for a failed API call, appending request
+     * metadata when {@link ApiRequestDebugInfo} is available.
+     *
+     * @param {string} message - Primary error text (HTTP message or generic).
+     * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
+     * @returns {string} Message plus indented Request details for troubleshooting.
+     */
+    formatApiFailure(message, response) {
+        const { debug, status } = response;
+        if (!debug) {
+            return message;
+        }
+        return [
+            message,
+            '',
+            chalk.dim('Request:'),
+            chalk.dim(`  URL: ${debug.fullUrl}`),
+            status > 0
+                ? chalk.dim(`  Status: ${String(status)}`)
+                : chalk.dim('  Status: (No HTTP response — network or client error)'),
+            ...(debug.responseSummary
+                ? [chalk.dim(`  Response: ${debug.responseSummary}`)]
+                : []),
+            ...(debug.causeCode
+                ? [chalk.dim(`  Error Code: ${debug.causeCode}`)]
+                : []),
+        ].join('\n');
     }
 }

package/dist/lib/config.js

@@ -13,6 +13,7 @@ const CONFIG_FILE = join(CONFIG_DIR, 'config');
  *   or null if the config file does not exist or is corrupted.
  */
 export async function loadConfig() {
+    console.log('Loading config from', CONFIG_FILE);
     if (!existsSync(CONFIG_FILE))
         return null;
     try {

package/dist/lib/constants.d.ts

@@ -1,22 +1,22 @@
 export declare const API_BASE_URL: string;
 export declare const API_ENDPOINTS: Readonly<{
-    ANALYTICS: "/analytics";
-    ANALYZE: "/analyze";
-    ASSETS_LOGO: "/assets/logo";
-    AUTH_VALIDATE: "/auth/validate";
-    BILLING_CAP: "/billing/cap";
-    BILLING_STATUS: "/billing/status";
-    CONTACTS: "/contacts";
-    CONTACTS_EXPORT: "/contacts/export";
-    DOMAIN: "/domain";
-    DOMAIN_STATUS: "/domain/status";
-    DOMAIN_VERIFY: "/domain/verify";
-    EDIT: "/edit";
-    EVENTS: "/events";
-    GENERATE: "/generate";
-    LOGS: "/logs";
-    PREVIEW: "/preview";
-    SEQUENCES: "/sequences";
+    ANALYTICS: "/api/analytics";
+    ANALYZE: "/api/analyze";
+    ASSETS_LOGO: "/api/assets/logo";
+    AUTH_VALIDATE: "/api/auth/validate";
+    BILLING_CAP: "/api/billing/cap";
+    BILLING_STATUS: "/api/billing/status";
+    CONTACTS: "/api/contacts";
+    CONTACTS_EXPORT: "/api/contacts/export";
+    DOMAIN: "/api/domain";
+    DOMAIN_STATUS: "/api/domain/status";
+    DOMAIN_VERIFY: "/api/domain/verify";
+    EDIT: "/api/edit";
+    EVENTS: "/api/events";
+    GENERATE: "/api/generate";
+    LOGS: "/api/logs";
+    PREVIEW: "/api/preview";
+    SEQUENCES: "/api/sequences";
 }>;
 export declare const SIGNUP_URL = "https://mailmodo.com/cli";
 export declare const DOCS_URL = "https://mailmodo.com/docs/cli";

package/dist/lib/constants.js

@@ -1,22 +1,27 @@
-export const API_BASE_URL = process.env.MAILMODO_API_URL || 'https://api.mailmodo.com/cli/v1';
+/** Set by `bin/dev.js` when running the CLI locally (tsx bootstrap). */
+const DEV_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
+const PRODUCTION_API_BASE_URL = 'https://api.mailmodo.com';
+export const API_BASE_URL = process.env.MAILMODO_DEV_TSX
+    ? DEV_API_BASE_URL
+    : PRODUCTION_API_BASE_URL;
 export const API_ENDPOINTS = Object.freeze({
-    ANALYTICS: '/analytics',
-    ANALYZE: '/analyze',
-    ASSETS_LOGO: '/assets/logo',
-    AUTH_VALIDATE: '/auth/validate',
-    BILLING_CAP: '/billing/cap',
-    BILLING_STATUS: '/billing/status',
-    CONTACTS: '/contacts',
-    CONTACTS_EXPORT: '/contacts/export',
-    DOMAIN: '/domain',
-    DOMAIN_STATUS: '/domain/status',
-    DOMAIN_VERIFY: '/domain/verify',
-    EDIT: '/edit',
-    EVENTS: '/events',
-    GENERATE: '/generate',
-    LOGS: '/logs',
-    PREVIEW: '/preview',
-    SEQUENCES: '/sequences',
+    ANALYTICS: '/api/analytics',
+    ANALYZE: '/api/analyze',
+    ASSETS_LOGO: '/api/assets/logo',
+    AUTH_VALIDATE: '/api/auth/validate',
+    BILLING_CAP: '/api/billing/cap',
+    BILLING_STATUS: '/api/billing/status',
+    CONTACTS: '/api/contacts',
+    CONTACTS_EXPORT: '/api/contacts/export',
+    DOMAIN: '/api/domain',
+    DOMAIN_STATUS: '/api/domain/status',
+    DOMAIN_VERIFY: '/api/domain/verify',
+    EDIT: '/api/edit',
+    EVENTS: '/api/events',
+    GENERATE: '/api/generate',
+    LOGS: '/api/logs',
+    PREVIEW: '/api/preview',
+    SEQUENCES: '/api/sequences',
 });
 export const SIGNUP_URL = 'https://mailmodo.com/cli';
 export const DOCS_URL = 'https://mailmodo.com/docs/cli';

package/dist/lib/yaml-config.js

@@ -31,7 +31,11 @@ export async function loadYaml(cwd) {
  */
 export async function saveYaml(config, cwd) {
     const filePath = join(cwd || process.cwd(), YAML_FILE);
-    const content = dump(config, { lineWidth: -1, noRefs: true, quotingType: '"' });
+    const content = dump(config, {
+        lineWidth: -1,
+        noRefs: true,
+        quotingType: '"',
+    });
     await writeFile(filePath, content);
 }
 /**

package/oclif.manifest.json

@@ -205,6 +205,45 @@
         "index.js"
       ]
     },
+    "emails": {
+      "aliases": [],
+      "args": {},
+      "description": "List and view configured email sequences",
+      "examples": [
+        "<%= config.bin %> emails",
+        "<%= config.bin %> emails --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "emails",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "emails",
+        "index.js"
+      ]
+    },
     "edit": {
       "aliases": [],
       "args": {
@@ -257,13 +296,13 @@
         "index.js"
       ]
     },
-    "emails": {
+    "init": {
       "aliases": [],
       "args": {},
-      "description": "List and view configured email sequences",
+      "description": "Analyze your product and generate email sequences",
       "examples": [
-        "<%= config.bin %> emails",
-        "<%= config.bin %> emails --json"
+        "<%= config.bin %> init",
+        "<%= config.bin %> init --url https://myapp.com --yes"
       ],
       "flags": {
         "json": {
@@ -278,11 +317,18 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "url": {
+          "description": "Product URL to analyze",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "emails",
+      "id": "init",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -292,17 +338,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "init",
         "index.js"
       ]
     },
-    "init": {
+    "logs": {
       "aliases": [],
       "args": {},
-      "description": "Analyze your product and generate email sequences",
+      "description": "View email send logs and delivery events",
       "examples": [
-        "<%= config.bin %> init",
-        "<%= config.bin %> init --url https://myapp.com --yes"
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs --email sarah@example.com",
+        "<%= config.bin %> logs --failed",
+        "<%= config.bin %> logs --json"
       ],
       "flags": {
         "json": {
@@ -318,17 +366,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "url": {
-          "description": "Product URL to analyze",
-          "name": "url",
+        "email": {
+          "description": "Filter logs by contact email",
+          "name": "email",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "failed": {
+          "description": "Show only failed/bounced events",
+          "name": "failed",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "init",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -338,7 +392,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "init",
+        "logs",
         "index.js"
       ]
     },
@@ -381,15 +435,14 @@
         "index.js"
       ]
     },
-    "logs": {
+    "settings": {
       "aliases": [],
       "args": {},
-      "description": "View email send logs and delivery events",
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -405,23 +458,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "email": {
-          "description": "Filter logs by contact email",
-          "name": "email",
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "failed": {
-          "description": "Show only failed/bounced events",
-          "name": "failed",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -431,7 +478,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "settings",
         "index.js"
       ]
     },
@@ -493,53 +540,6 @@
         "index.js"
       ]
     },
-    "settings": {
-      "aliases": [],
-      "args": {},
-      "description": "View and update project settings",
-      "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "settings",
-      "pluginAlias": "@mailmodo/cli",
-      "pluginName": "@mailmodo/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "settings",
-        "index.js"
-      ]
-    },
     "status": {
       "aliases": [],
       "args": {},
@@ -580,5 +580,5 @@
       ]
     }
   },
-  "version": "0.0.7"
+  "version": "0.0.8-beta.pr10.14"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.7",
+  "version": "0.0.8-beta.pr10.14",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"