m3triq 0.2.4 → 0.2.6

package/dist/cli.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { setJsonMode } from './output.js';
 import { getEffectiveConfig, requireApiKey } from './config.js';
 import { M3triqClient, AgentsClient } from './client.js';
+import { reportCliError } from './errorReporter.js';
 import { registerConfigCommands } from './commands/config-cmd.js';
 import { registerProjectCommands } from './commands/projects.js';
 import { registerSessionCommands } from './commands/sessions.js';
@@ -23,7 +24,7 @@ const program = new Command();
 program
     .name('m3t')
     .description('M3TRIQ — protein-ligand analysis from the terminal')
-    .version('0.2.4')
+    .version('0.2.6')
     .option('--json', 'Output as JSON (machine-readable)')
     .hook('preAction', (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
@@ -46,8 +47,37 @@ registerMdCommands(program);
 registerZincCommands(program);
 registerCreditsCommands(program);
 registerPricingCommands(program);
+// Last-line-of-defense catches: anything that escapes a command handler.
+// These fire BEFORE process.exit(), so the reporter has time to flush
+// (it has its own 3-second timeout to bound the wait).
+process.on('uncaughtException', async (err) => {
+    try {
+        await reportCliError(err, { kind: 'uncaughtException' });
+    }
+    catch { }
+    process.stderr.write(`Error: ${err?.message || String(err)}\n`);
+    process.exit(1);
+});
+process.on('unhandledRejection', async (reason) => {
+    try {
+        await reportCliError(reason, { kind: 'unhandledRejection' });
+    }
+    catch { }
+    const msg = reason instanceof Error ? reason.message : String(reason);
+    process.stderr.write(`Error: ${msg}\n`);
+    process.exit(1);
+});
 // Catch async errors from all command actions
-program.parseAsync().catch((err) => {
+program.parseAsync().catch(async (err) => {
+    // Don't beacon commander's own user-facing exits (--help, --version, bad args).
+    const code = err.code;
+    const isCommanderExit = typeof code === 'string' && code.startsWith('commander.');
+    if (!isCommanderExit) {
+        try {
+            await reportCliError(err, { kind: 'command' });
+        }
+        catch { }
+    }
     const message = err.message || String(err);
     if (message.includes('API error') || message.includes('MCP')) {
         process.stderr.write(`Error: ${message}\n`);

package/dist/commands/config-cmd.js

@@ -7,6 +7,7 @@ export function registerConfigCommands(program) {
         .option('--key <api-key>', 'Set API key')
         .option('--url <api-url>', 'Set API URL')
         .option('--console <console-url>', 'Set console URL')
+        .option('--error-reporting <on|off>', 'Toggle anonymous error reporting (default: on)')
         .action((opts) => {
         const config = loadConfig();
         // Update fields if provided
@@ -23,6 +24,21 @@ export function registerConfigCommands(program) {
             config.console_url = opts.console;
             updated = true;
         }
+        if (opts.errorReporting !== undefined) {
+            const v = String(opts.errorReporting).toLowerCase();
+            if (['off', 'false', '0', 'no'].includes(v)) {
+                config.error_reporting_disabled = true;
+                updated = true;
+            }
+            else if (['on', 'true', '1', 'yes'].includes(v)) {
+                config.error_reporting_disabled = false;
+                updated = true;
+            }
+            else {
+                process.stderr.write(`Error: --error-reporting expects on|off (got "${opts.errorReporting}")\n`);
+                process.exit(1);
+            }
+        }
         if (updated) {
             saveConfig(config);
             process.stderr.write('Config saved.\n');
@@ -38,14 +54,16 @@ export function registerConfigCommands(program) {
             console_url: effective.console_url,
             active_project: effective.active_project || null,
             active_project_name: effective.active_project_name || null,
+            error_reporting: effective.error_reporting_disabled ? 'off' : 'on',
         };
         const local = loadLocalProject();
         const projectSource = local ? 'local .m3triq' : effective.active_project ? 'global' : '';
         const human = [
-            `API Key:     ${maskedKey}`,
-            `API URL:     ${effective.api_url}`,
-            `Console URL: ${effective.console_url}`,
-            `Project:     ${effective.active_project_name || '(none)'} ${effective.active_project ? `(${effective.active_project.substring(0, 8)})` : ''} ${projectSource ? `[${projectSource}]` : ''}`,
+            `API Key:         ${maskedKey}`,
+            `API URL:         ${effective.api_url}`,
+            `Console URL:     ${effective.console_url}`,
+            `Project:         ${effective.active_project_name || '(none)'} ${effective.active_project ? `(${effective.active_project.substring(0, 8)})` : ''} ${projectSource ? `[${projectSource}]` : ''}`,
+            `Error reporting: ${effective.error_reporting_disabled ? 'off' : 'on'}`,
         ].join('\n');
         output(data, human);
     });

package/dist/commands/md.js

@@ -11,8 +11,8 @@ export function registerMdCommands(program) {
     md
         .command('run')
         .option('--protein <pdb>', 'Protein PDB ID or path to .pdb file')
-        .option('--ligand-sdf <sdf>', 'Ligand SDF content or path to .sdf file')
-        .option('--ligand-smiles <smiles>', 'Ligand SMILES (fallback if no SDF)')
+        .option('--ligand-sdf <sdf>', 'Ligand SDF content or path to .sdf file (omit for apo simulation)')
+        .option('--ligand-smiles <smiles>', 'Ligand SMILES (omit for apo simulation)')
         .option('--diffdock-job <id>', 'DiffDock job ID (auto-fetches protein + ligand)')
         .option('--mode <mode>', 'Simulation mode: quick (10ns ~1hr) or standard (50ns ~5hrs)', 'quick')
         .option('--ns <n>', 'Override simulation duration in nanoseconds (1-100)')
@@ -42,7 +42,7 @@ export function registerMdCommands(program) {
             else {
                 params.protein_pdb = opts.protein;
             }
-            // Resolve ligand
+            // Resolve ligand (optional — omit for apo / protein-only MD)
             if (opts.ligandSdf) {
                 if (fs.existsSync(opts.ligandSdf)) {
                     params.ligand_sdf = fs.readFileSync(opts.ligandSdf, 'utf-8');
@@ -55,8 +55,7 @@ export function registerMdCommands(program) {
                 params.ligand_smiles = opts.ligandSmiles;
             }
             else {
-                process.stderr.write('Error: Provide --ligand-sdf or --ligand-smiles\n');
-                process.exit(1);
+                process.stderr.write('Running protein-only (apo) MD — no ligand specified.\n');
             }
         }
         if (opts.ns)

package/dist/config.d.ts

@@ -5,6 +5,7 @@ export interface M3triqConfig {
     console_url?: string;
     active_project?: string;
     active_project_name?: string;
+    error_reporting_disabled?: boolean;
 }
 interface LocalProjectConfig {
     project_id: string;

package/dist/errorReporter.d.ts

@@ -0,0 +1,5 @@
+export interface ReportContext {
+    kind?: string;
+    argv?: string[];
+}
+export declare function reportCliError(err: unknown, context?: ReportContext): Promise<void>;

package/dist/errorReporter.js

@@ -0,0 +1,77 @@
+// Beacon CLI errors to Django POST /api/errors/.
+// Best-effort: never throws, never blocks the exit beyond ~3 seconds.
+import os from 'node:os';
+import { getEffectiveConfig } from './config.js';
+const REPORT_TIMEOUT_MS = 3000;
+export async function reportCliError(err, context = {}) {
+    let config;
+    try {
+        config = getEffectiveConfig();
+    }
+    catch {
+        return;
+    }
+    // Opt-out gate. Either the config flag or env var disables reporting.
+    if (config.error_reporting_disabled === true)
+        return;
+    if (process.env.M3TRIQ_NO_ERROR_REPORTING === '1')
+        return;
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = err instanceof Error ? (err.stack || '') : '';
+    const argv = (context.argv || process.argv).slice(1);
+    // Replace any token-like value (long hex/base64 strings) with a placeholder.
+    const sanitizedArgv = argv.map(a => /^[A-Za-z0-9_\-+/=]{32,}$/.test(a) ? '<redacted>' : a);
+    const url_or_cmd = sanitizedArgv.join(' ').slice(0, 500);
+    const cliVersion = await readCliVersion();
+    const payload = {
+        source: 'cli',
+        session_id: '',
+        url_or_cmd,
+        message: message.slice(0, 5000),
+        stack: stack.slice(0, 10000),
+        metadata: {
+            kind: context.kind || 'command',
+            cli_version: cliVersion,
+            node_version: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            os_release: os.release(),
+        },
+    };
+    const url = `${config.api_url || 'https://server.m3triq.com'}/api/errors/`;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), REPORT_TIMEOUT_MS);
+    try {
+        await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: ctrl.signal,
+        });
+    }
+    catch {
+        // Best-effort: swallow network errors, timeouts, anything.
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+let _cachedVersion = null;
+async function readCliVersion() {
+    if (_cachedVersion)
+        return _cachedVersion;
+    try {
+        const fs = await import('node:fs');
+        const path = await import('node:path');
+        const url = await import('node:url');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkgPath = path.join(here, '..', 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        _cachedVersion = pkg.version || 'unknown';
+        return _cachedVersion;
+    }
+    catch {
+        _cachedVersion = 'unknown';
+        return _cachedVersion;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "m3triq",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "M3TRIQ — protein-ligand analysis from the terminal",
   "type": "module",
   "bin": {