geotechcli 0.4.0 → 0.4.2

package/dist/commands/viz.js

@@ -0,0 +1,209 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { banner, heading, renderChart, renderMultiChart, renderXYPlot, warn, } from '../ui/terminal.js';
+import { buildAtterbergChart, buildMohrCircleChart, loadVisualizationSource, } from '../util/viz.js';
+function summarizeDomain(values) {
+    if (values.length === 0) {
+        return 'No samples';
+    }
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    return `${min.toFixed(2)} to ${max.toFixed(2)} (${values.length} samples)`;
+}
+function renderVisualization(chart, height) {
+    heading(chart.title);
+    if (chart.kind === 'xy') {
+        console.log(chalk.gray(`  X-axis: ${chart.xLabel}${chart.xScale === 'log10' ? ' (log scale)' : ''}`));
+        console.log(chalk.gray(`  Y-axis: ${chart.yLabel}`));
+        if (chart.note) {
+            console.log(chalk.gray(`  ${chart.note}`));
+        }
+        renderXYPlot(chart.xySeries ?? [], {
+            height,
+            title: chart.title,
+            xLabel: chart.xLabel,
+            yLabel: chart.yLabel,
+            xScale: chart.xScale,
+            xDomain: chart.xDomain,
+            yDomain: chart.yDomain,
+            invertY: chart.invertY,
+        });
+        return;
+    }
+    const xValues = chart.xValues ?? [];
+    const series = chart.series ?? [];
+    const labels = chart.labels ?? [];
+    console.log(chalk.gray(`  X-axis: ${chart.xLabel} | Domain: ${summarizeDomain(xValues)}`));
+    console.log(chalk.gray(`  Y-axis: ${chart.yLabel}`));
+    if (chart.note) {
+        console.log(chalk.gray(`  ${chart.note}`));
+    }
+    if (series.length > 1) {
+        renderMultiChart(series, labels, {
+            height,
+            title: `${chart.title} (${chart.xLabel})`,
+        });
+    }
+    else if (series[0]) {
+        renderChart(series[0], {
+            height,
+            label: `${labels[0] ?? chart.yLabel} (${chart.xLabel})`,
+        });
+    }
+}
+function printChartCatalog(charts) {
+    console.log('');
+    console.log(chalk.cyan('  Available charts:'));
+    charts.forEach((chart, index) => {
+        console.log(chalk.gray(`    ${String(index + 1).padStart(2, ' ')}. `) + chalk.white(chart.id) + chalk.gray(`  - ${chart.title}`));
+    });
+    console.log('');
+}
+async function browseChartsInteractively(charts, height) {
+    const rl = createInterface({ input, output });
+    try {
+        while (true) {
+            printChartCatalog(charts);
+            const answer = (await rl.question('  Select chart number, "a" for all, or "q" to quit: ')).trim().toLowerCase();
+            if (answer === 'q') {
+                console.log('');
+                break;
+            }
+            if (answer === 'a') {
+                for (const chart of charts) {
+                    renderVisualization(chart, height);
+                }
+                continue;
+            }
+            const selectedIndex = Number(answer);
+            if (!Number.isInteger(selectedIndex) || selectedIndex < 1 || selectedIndex > charts.length) {
+                warn(`Invalid selection "${answer}".`);
+                continue;
+            }
+            renderVisualization(charts[selectedIndex - 1], height);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+function loadPresetSource(preset, opts) {
+    switch (preset) {
+        case 'mohr':
+        case 'mohr-circle':
+            return {
+                sourceType: 'preset',
+                sourceName: 'mohr-circle',
+                charts: [
+                    buildMohrCircleChart({
+                        sigma1: Number(opts.sigma1),
+                        sigma3: Number(opts.sigma3),
+                        cohesion: opts.cohesion !== undefined ? Number(opts.cohesion) : undefined,
+                        frictionAngle: opts.phi !== undefined ? Number(opts.phi) : undefined,
+                    }),
+                ],
+            };
+        case 'atterberg':
+        case 'plasticity':
+            return {
+                sourceType: 'preset',
+                sourceName: 'atterberg',
+                charts: [
+                    buildAtterbergChart({
+                        liquidLimit: Number(opts.ll),
+                        plasticityIndex: opts.pi !== undefined ? Number(opts.pi) : undefined,
+                        plasticLimit: opts.pl !== undefined ? Number(opts.pl) : undefined,
+                    }),
+                ],
+            };
+        default:
+            throw new Error(`Unsupported preset "${preset}". Use mohr-circle or atterberg.`);
+    }
+}
+export function registerVizCommand(program) {
+    const cmd = new Command('viz')
+        .description('Interactive terminal visualization for saved data, engineering presets, and geotechnical chart templates')
+        .argument('[file]', 'Visualization source file (.json, .csv, .xlsx)')
+        .option('--chart <id>', 'Render a specific chart id directly')
+        .option('--list', 'List available charts without rendering')
+        .option('--all', 'Render all detected charts')
+        .option('--sheet <name>', 'Workbook sheet name for .xlsx inputs')
+        .option('--x <column>', 'Override the X-axis column for tabular inputs')
+        .option('--y <columns>', 'Comma-separated Y columns for tabular inputs')
+        .option('--height <rows>', 'Chart height in terminal rows', (value) => parseInt(value, 10), 12)
+        .option('--template <name>', 'File template: compaction | gradation | cpt')
+        .option('--preset <name>', 'Preset chart: mohr-circle | atterberg')
+        .option('--sigma1 <kPa>', 'Major principal stress for Mohr circle preset', (value) => parseFloat(value))
+        .option('--sigma3 <kPa>', 'Minor principal stress for Mohr circle preset', (value) => parseFloat(value))
+        .option('--cohesion <kPa>', 'Cohesion intercept for Mohr-Coulomb envelope', (value) => parseFloat(value))
+        .option('--phi <deg>', 'Friction angle for Mohr-Coulomb envelope', (value) => parseFloat(value))
+        .option('--ll <percent>', 'Liquid limit for Atterberg plasticity chart', (value) => parseFloat(value))
+        .option('--pl <percent>', 'Plastic limit for Atterberg plasticity chart', (value) => parseFloat(value))
+        .option('--pi <percent>', 'Plasticity index for Atterberg plasticity chart', (value) => parseFloat(value))
+        .addHelpText('after', `
+  Examples:
+    geotech viz samples/visualization/geotech-viz-showcase.csv
+    geotech viz samples/visualization/geotech-viz-showcase.xlsx --sheet settlement_profile
+    geotech viz samples/visualization/geotech-viz-compaction.csv --template compaction
+    geotech viz samples/visualization/geotech-viz-gradation.csv --template gradation
+    geotech viz output/liquefaction.json --list
+    geotech viz --preset mohr-circle --sigma1 250 --sigma3 90 --cohesion 15 --phi 28
+    geotech viz --preset atterberg --ll 55 --pl 25
+`)
+        .action(async (filePath, opts) => {
+        if (opts.preset && filePath) {
+            throw new Error('Use either a <file> input or --preset, not both at the same time.');
+        }
+        if (!opts.preset && !filePath) {
+            throw new Error('Provide a visualization file or use --preset for a built-in engineering chart.');
+        }
+        const yColumns = typeof opts.y === 'string'
+            ? opts.y.split(',').map((value) => value.trim()).filter((value) => value.length > 0)
+            : undefined;
+        const source = opts.preset
+            ? loadPresetSource(String(opts.preset).toLowerCase(), opts)
+            : await loadVisualizationSource(filePath, {
+                sheetName: opts.sheet,
+                xColumn: opts.x,
+                yColumns,
+                template: opts.template,
+            });
+        if (source.charts.length === 0) {
+            if (opts.template) {
+                throw new Error(`No chartable data found in ${filePath} for template "${opts.template}".`);
+            }
+            throw new Error(`No chartable data found in ${filePath}. Save JSON output from a supported command, or provide numeric CSV/XLSX columns.`);
+        }
+        banner();
+        console.log(chalk.gray(`  Source: ${opts.preset ? `preset:${opts.preset}` : filePath} (${source.sourceType.toUpperCase()})`));
+        console.log(chalk.gray(`  Charts detected: ${source.charts.length}`));
+        if (opts.list) {
+            printChartCatalog(source.charts);
+            return;
+        }
+        if (typeof opts.chart === 'string') {
+            const match = source.charts.find((chart) => chart.id === opts.chart);
+            if (!match) {
+                throw new Error(`Chart "${opts.chart}" not found. Run "geotech viz ${filePath ?? `--preset ${opts.preset}`} --list" to inspect available chart ids.`);
+            }
+            renderVisualization(match, opts.height);
+            return;
+        }
+        if (opts.all || source.charts.length === 1 || !input.isTTY) {
+            if (!input.isTTY && source.charts.length > 1 && !opts.all) {
+                warn('Interactive mode is unavailable in this shell. Rendering the first chart only.');
+                renderVisualization(source.charts[0], opts.height);
+                return;
+            }
+            for (const chart of source.charts) {
+                renderVisualization(chart, opts.height);
+            }
+            return;
+        }
+        await browseChartsInteractively(source.charts, opts.height);
+    });
+    program.addCommand(cmd);
+}
+//# sourceMappingURL=viz.js.map

package/dist/commands/viz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz.js","sourceRoot":"","sources":["../../src/commands/viz.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,6 +15,7 @@ import { registerSlopeCommand } from './commands/slope.js';
 import { registerRetainingCommand } from './commands/retaining.js';
 import { registerSettlementCommands } from './commands/settlement.js';
 import { registerSeepageCommand } from './commands/seepage.js';
+import { registerVizCommand } from './commands/viz.js';
 import { registerVisionCommand, registerAIClassifyCommand, registerGBRCommand, registerAgentCommand, registerReportCommand, registerChatCommand, } from './commands/ai.js';
 const program = new Command();
 program
@@ -37,6 +38,7 @@ registerRetainingCommand(program);
 registerSettlementCommands(program);
 // Seepage
 registerSeepageCommand(program);
+registerVizCommand(program);
 // Tunnel engineering
 registerTunnelCommands(program);
 // ---------------------------------------------------------------------------
@@ -54,9 +56,10 @@ registerBridgeCommand(program);
 // System
 registerConfigCommand(program);
 registerStatusCommand(program);
-// Show banner when invoked with no arguments
+// Show help when invoked with no arguments and exit cleanly.
 if (process.argv.length <= 2) {
-    banner();
+    program.outputHelp();
+    process.exit(0);
 }
 // ---------------------------------------------------------------------------
 // Error handling — never leak API keys in stack traces
@@ -70,6 +73,9 @@ catch (err) {
         if ('exitCode' in err && err.exitCode === 0) {
             process.exit(0);
         }
+        if ('code' in err && err.code === 'commander.helpDisplayed') {
+            process.exit(0);
+        }
         const msg = err.message.replace(/(?:Bearer |sk-|zhipu-|api[_-]?key[=: ]*)[^\s"'\]},]*/gi, '***REDACTED***');
         console.error(`\n  Error: ${msg}\n`);
         process.exit(1);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/ui/terminal.d.ts

@@ -1,3 +1,13 @@
+export interface XYPoint {
+    x: number;
+    y: number;
+}
+export interface XYSeriesSpec {
+    label: string;
+    points: XYPoint[];
+    style?: 'line' | 'scatter';
+    symbol?: string;
+}
 export declare function banner(): void;
 export declare function heading(text: string): void;
 export declare function success(text: string): void;
@@ -10,12 +20,22 @@ export declare function renderTable(headers: string[], rows: (string | number)[]
 export declare function renderChart(data: number[], options?: {
     height?: number;
     label?: string;
-    colors?: readonly string[];
 }): void;
 export declare function renderMultiChart(series: number[][], labels: string[], options?: {
     height?: number;
     title?: string;
 }): void;
+export declare function renderXYPlot(series: XYSeriesSpec[], options?: {
+    height?: number;
+    width?: number;
+    title?: string;
+    xLabel?: string;
+    yLabel?: string;
+    xScale?: 'linear' | 'log10';
+    xDomain?: [number, number];
+    yDomain?: [number, number];
+    invertY?: boolean;
+}): void;
 export declare function renderSteps(steps: string[], verbose: boolean): void;
 export declare function renderJSON(data: unknown): void;
 //# sourceMappingURL=terminal.d.ts.map

package/dist/ui/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/ui/terminal.ts"],"names":[],"mappings":"AAQA,wBAAgB,MAAM,IAAI,IAAI,CAmB7B;AAGD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAMD,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,GAC1B,IAAI,CAyCN;AAMD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACxE,IAAI,CAgBN;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CA8BN;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQnE;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAY9C"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/ui/terminal.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD,wBAAgB,MAAM,IAAI,IAAI,CAU7B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,GAAG,IAAI,CA8BhF;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CAgBN;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,IAAI,CA0BN;AAoCD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,IAAI,CA4GN;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQnE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAW9C"}

package/dist/ui/terminal.js

@@ -1,94 +1,70 @@
 import chalk from 'chalk';
 import * as asciichart from 'asciichart';
 import { GEOTECHCLI_VERSION } from '@geotechcli/core';
-// ---------------------------------------------------------------------------
-// Branded output
-// ---------------------------------------------------------------------------
+function stripAnsi(value) {
+    return value.replace(/\x1b\[[0-9;]*m/g, '');
+}
+function pad(value, width) {
+    const visible = stripAnsi(value).length;
+    return `${value}${' '.repeat(Math.max(0, width - visible))}`;
+}
 export function banner() {
-    const c = chalk.bold.cyan;
-    const w = chalk.bold.white;
-    const g = chalk.gray;
     console.log('');
-    console.log(c('  ██████╗ ███████╗ ██████╗ ████████╗███████╗ ██████╗██╗  ██╗ ██████╗██╗     ██╗'));
-    console.log(c(' ██╔════╝ ██╔════╝██╔═══██╗╚══██╔══╝██╔════╝██╔════╝██║  ██║██╔════╝██║     ██║'));
-    console.log(w(' ██║  ███╗█████╗  ██║   ██║   ██║   █████╗  ██║     ███████║██║     ██║     ██║'));
-    console.log(w(' ██║   ██║██╔══╝  ██║   ██║   ██║   ██╔══╝  ██║     ██╔══██║██║     ██║     ██║'));
-    console.log(c(' ╚██████╔╝███████╗╚██████╔╝   ██║   ███████╗╚██████╗██║  ██║╚██████╗███████╗██║'));
-    console.log(c('  ╚═════╝ ╚══════╝ ╚═════╝    ╚═╝   ╚══════╝ ╚═════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝'));
-    console.log('');
-    console.log(g('  v') + chalk.cyan(GEOTECHCLI_VERSION) +
-        g('  ·  AI-native geotechnical engineering  ·  ') +
-        chalk.dim('https://beta.geotechcli.com'));
+    console.log(chalk.bold.cyan('  ██████╗ ███████╗ ██████╗ ████████╗███████╗ ██████╗██╗  ██╗ ██████╗██╗     ██╗'));
+    console.log(chalk.bold.cyan(' ██╔════╝ ██╔════╝██╔═══██╗╚══██╔══╝██╔════╝██╔════╝██║  ██║██╔════╝██║     ██║'));
+    console.log(chalk.bold.white(' ██║  ███╗█████╗  ██║   ██║   ██║   █████╗  ██║     ███████║██║     ██║     ██║'));
+    console.log(chalk.bold.white(' ██║   ██║██╔══╝  ██║   ██║   ██║   ██╔══╝  ██║     ██╔══██║██║     ██║     ██║'));
+    console.log(chalk.bold.cyan(' ╚██████╔╝███████╗╚██████╔╝   ██║   ███████╗╚██████╗██║  ██║╚██████╗███████╗██║'));
+    console.log(chalk.bold.cyan('  ╚═════╝ ╚══════╝ ╚═════╝    ╚═╝   ╚══════╝ ╚═════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝'));
+    console.log(chalk.gray(`  v${GEOTECHCLI_VERSION} | AI-native geotechnical engineering | https://beta.geotechcli.com`));
     console.log('');
 }
 export function heading(text) {
     console.log('');
     console.log(chalk.bold.white(`  ${text}`));
-    console.log(chalk.gray('  ' + '─'.repeat(Math.min(text.length + 4, 60))));
+    console.log(chalk.gray(`  ${'-'.repeat(Math.min(text.length + 4, 60))}`));
 }
 export function success(text) {
-    console.log(chalk.green('  ✓ ') + text);
+    console.log(chalk.green(`  OK    ${text}`));
 }
 export function warn(text) {
-    console.log(chalk.yellow('  ⚠ ') + text);
+    console.log(chalk.yellow(`  WARN  ${text}`));
 }
 export function error(text) {
-    console.log(chalk.red('  ✗ ') + text);
+    console.log(chalk.red(`  ERR   ${text}`));
 }
 export function info(text) {
-    console.log(chalk.blue('  ℹ ') + text);
+    console.log(chalk.blue(`  INFO  ${text}`));
 }
 export function dim(text) {
     console.log(chalk.gray(`  ${text}`));
 }
 export function keyValue(key, value) {
     console.log(chalk.gray('  ') +
-        chalk.white.bold(key.padEnd(28)) +
+        chalk.white.bold(pad(key, 28)) +
         chalk.cyan(String(value)));
 }
-// ---------------------------------------------------------------------------
-// Tables
-// ---------------------------------------------------------------------------
 export function renderTable(headers, rows) {
-    // Calculate column widths (strip ANSI for measurement)
-    const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, '');
-    const allRows = [headers, ...rows.map((r) => r.map(String))];
-    const colWidths = headers.map((_, ci) => Math.max(...allRows.map((r) => stripAnsi(String(r[ci] ?? '')).length)) + 2);
-    const pad = (s, w) => {
-        const visible = stripAnsi(s).length;
-        return ' ' + s + ' '.repeat(Math.max(0, w - visible - 1));
-    };
-    const colorCell = (s) => {
-        if (s === 'SEVERE' || s === 'HIGH')
-            return chalk.red.bold(s);
-        if (s === 'MODERATE')
-            return chalk.yellow(s);
-        if (s === 'LOW')
-            return chalk.green(s);
-        return s;
-    };
-    const topBorder = chalk.gray('  ┌' + colWidths.map((w) => '─'.repeat(w)).join('┬') + '┐');
-    const midBorder = chalk.gray('  ├' + colWidths.map((w) => '─'.repeat(w)).join('┼') + '┤');
-    const botBorder = chalk.gray('  └' + colWidths.map((w) => '─'.repeat(w)).join('┴') + '┘');
-    const formatRow = (cells, isHeader = false) => {
-        const formatted = cells.map((c, i) => {
-            const display = isHeader ? chalk.cyan.bold(c) : colorCell(c);
-            return pad(display, colWidths[i]);
-        });
-        return chalk.gray('  │') + formatted.join(chalk.gray('│')) + chalk.gray('│');
+    const stringRows = rows.map((row) => row.map((cell) => String(cell)));
+    const allRows = [headers, ...stringRows];
+    const colWidths = headers.map((_, columnIndex) => Math.max(...allRows.map((row) => stripAnsi(row[columnIndex] ?? '').length)) + 2);
+    const makeBorder = (left, mid, right) => chalk.gray(`  ${left}${colWidths.map((width) => '-'.repeat(width + 2)).join(mid)}${right}`);
+    const formatCell = (value, columnIndex, isHeader = false) => {
+        const display = isHeader ? chalk.cyan.bold(value) : value;
+        return ` ${pad(display, colWidths[columnIndex])} `;
     };
+    const formatRow = (cells, isHeader = false) => chalk.gray('  |') +
+        cells.map((cell, index) => formatCell(cell, index, isHeader)).join(chalk.gray('|')) +
+        chalk.gray('|');
     console.log('');
-    console.log(topBorder);
+    console.log(makeBorder('+', '+', '+'));
     console.log(formatRow(headers, true));
-    console.log(midBorder);
-    for (const row of rows) {
-        console.log(formatRow(row.map(String)));
+    console.log(makeBorder('+', '+', '+'));
+    for (const row of stringRows) {
+        console.log(formatRow(row));
     }
-    console.log(botBorder);
+    console.log(makeBorder('+', '+', '+'));
 }
-// ---------------------------------------------------------------------------
-// Charts (ASCII line chart for --plot)
-// ---------------------------------------------------------------------------
 export function renderChart(data, options) {
     const height = options?.height ?? 12;
     console.log('');
@@ -123,16 +99,115 @@ export function renderMultiChart(series, labels, options) {
         format: (x) => x.toFixed(1).padStart(8),
     });
     console.log(chart);
-    // Legend
-    const legend = labels
-        .map((l, i) => chalk.hex(i === 0 ? '#00ffff' : i === 1 ? '#ffff00' : i === 2 ? '#ff0000' : '#00ff00')(`■ ${l}`))
-        .join('  ');
+    const legend = labels.map((label, index) => `${index + 1}:${label}`).join('  ');
     console.log(`    ${legend}`);
     console.log('');
 }
-// ---------------------------------------------------------------------------
-// Steps (verbose output)
-// ---------------------------------------------------------------------------
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function expandDomain(min, max) {
+    if (min === max) {
+        const delta = Math.abs(min) > 1 ? Math.abs(min) * 0.1 : 1;
+        return [min - delta, max + delta];
+    }
+    return [min, max];
+}
+function interpolateLine(startCol, startRow, endCol, endRow, symbol, grid) {
+    const steps = Math.max(Math.abs(endCol - startCol), Math.abs(endRow - startRow));
+    if (steps === 0) {
+        grid[startRow][startCol] = symbol;
+        return;
+    }
+    for (let index = 0; index <= steps; index += 1) {
+        const t = index / steps;
+        const col = Math.round(startCol + (endCol - startCol) * t);
+        const row = Math.round(startRow + (endRow - startRow) * t);
+        grid[row][col] = symbol;
+    }
+}
+export function renderXYPlot(series, options) {
+    const height = Math.max(8, options?.height ?? 14);
+    const width = Math.max(28, options?.width ?? 60);
+    const xScale = options?.xScale ?? 'linear';
+    const symbols = ['*', 'o', 'x', '+', '#'];
+    const transformedSeries = series
+        .map((entry, index) => {
+        const points = entry.points
+            .filter((point) => Number.isFinite(point.x) && Number.isFinite(point.y))
+            .filter((point) => xScale === 'linear' || point.x > 0)
+            .map((point) => ({
+            x: xScale === 'log10' ? Math.log10(point.x) : point.x,
+            y: point.y,
+            rawX: point.x,
+            rawY: point.y,
+        }));
+        return {
+            ...entry,
+            symbol: entry.symbol ?? symbols[index % symbols.length],
+            points,
+        };
+    })
+        .filter((entry) => entry.points.length > 0);
+    if (transformedSeries.length === 0) {
+        warn('No plottable XY data found for this chart.');
+        return;
+    }
+    const allX = transformedSeries.flatMap((entry) => entry.points.map((point) => point.x));
+    const allY = transformedSeries.flatMap((entry) => entry.points.map((point) => point.y));
+    const rawX = transformedSeries.flatMap((entry) => entry.points.map((point) => point.rawX));
+    const transformedDomain = options?.xDomain && xScale === 'log10'
+        ? [Math.log10(options.xDomain[0]), Math.log10(options.xDomain[1])]
+        : options?.xDomain;
+    const [xMin, xMax] = expandDomain(transformedDomain?.[0] ?? Math.min(...allX), transformedDomain?.[1] ?? Math.max(...allX));
+    const [yMin, yMax] = expandDomain(options?.yDomain?.[0] ?? Math.min(...allY), options?.yDomain?.[1] ?? Math.max(...allY));
+    const grid = Array.from({ length: height }, () => Array.from({ length: width }, () => ' '));
+    const xToColumn = (value) => clamp(Math.round(((value - xMin) / (xMax - xMin)) * (width - 1)), 0, width - 1);
+    const yToRow = (value) => {
+        const normalized = (value - yMin) / (yMax - yMin);
+        const row = options?.invertY
+            ? Math.round(normalized * (height - 1))
+            : Math.round((1 - normalized) * (height - 1));
+        return clamp(row, 0, height - 1);
+    };
+    if (xScale === 'linear' && xMin <= 0 && xMax >= 0) {
+        const axisCol = xToColumn(0);
+        for (let row = 0; row < height; row += 1) {
+            grid[row][axisCol] = '|';
+        }
+    }
+    if (yMin <= 0 && yMax >= 0) {
+        const axisRow = yToRow(0);
+        for (let col = 0; col < width; col += 1) {
+            grid[axisRow][col] = '-';
+        }
+    }
+    if (xScale === 'linear' && xMin <= 0 && xMax >= 0 && yMin <= 0 && yMax >= 0) {
+        grid[yToRow(0)][xToColumn(0)] = '+';
+    }
+    for (const entry of transformedSeries) {
+        const symbol = entry.symbol ?? '*';
+        for (let index = 0; index < entry.points.length; index += 1) {
+            const point = entry.points[index];
+            const col = xToColumn(point.x);
+            const row = yToRow(point.y);
+            grid[row][col] = symbol;
+            if (entry.style !== 'scatter' && index > 0) {
+                const previous = entry.points[index - 1];
+                interpolateLine(xToColumn(previous.x), yToRow(previous.y), col, row, symbol, grid);
+            }
+        }
+    }
+    console.log('');
+    if (options?.title) {
+        console.log(chalk.gray(`  ${options.title}`));
+    }
+    console.log(grid.map((row) => `    ${row.join('')}`).join('\n'));
+    console.log(chalk.gray(`    x: ${Math.min(...rawX).toFixed(2)} to ${Math.max(...rawX).toFixed(2)}${xScale === 'log10' ? ' (log scale)' : ''}${options?.xLabel ? ` | ${options.xLabel}` : ''}`));
+    console.log(chalk.gray(`    y: ${yMin.toFixed(2)} to ${yMax.toFixed(2)}${options?.yLabel ? ` | ${options.yLabel}` : ''}`));
+    console.log(`    ${transformedSeries.map((entry) => `${entry.symbol}=${entry.label}`).join('  ')}`);
+    console.log('');
+}
 export function renderSteps(steps, verbose) {
     if (!verbose)
         return;
@@ -142,11 +217,7 @@ export function renderSteps(steps, verbose) {
         console.log(chalk.gray(`    ${step}`));
     }
 }
-// ---------------------------------------------------------------------------
-// JSON output
-// ---------------------------------------------------------------------------
 export function renderJSON(data) {
-    // Security: strip any apiKey/api_key/token fields before output
     const sanitized = JSON.parse(JSON.stringify(data, (key, value) => {
         if (/api.?key|token|secret|password/i.test(key)) {
             if (typeof value === 'boolean' || typeof value === 'number' || value == null) {