@ascdong/nexus 0.1.2 → 0.1.3

package/README.md

@@ -140,10 +140,10 @@ The `envelope` form declares column names once (instead of repeating them on eve
 
 ## Output channels & exit codes
 
-- **Results** go to **stdout**; **logs and errors** go to **stderr** — so an Agent can parse stdout cleanly.
+- **Results** go to **stdout**; **diagnostic logs** go to **stderr** — so an Agent can parse stdout cleanly.
 - Exit codes: `0` success, `1` query/connection/auth error, `2` usage/config error.
 
-On error, `json`/`envelope` output a structured `{ "status": "error", "code": "...", "message": "..." }`.
+On error, `json`/`envelope` mode writes a structured `{ "status": "error", "code": "...", "message": "..." }` to **stdout** (so the single stream stays self-describing — `status` is `"ok"` or `"error"`), while the default `table` mode prints `error [CODE]: message` to **stderr**. Either way the exit code is non-zero.
 
 ## Extending
 

package/dist/cli.js

@@ -4,6 +4,7 @@ import { pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { register } from "./core/registry.js";
 import { ConnectorError, exitCodeFor } from "./core/errors.js";
+import { renderError } from "./core/output.js";
 import { makeLogAnalyticsConnector } from "./connectors/logAnalytics.js";
 import { makeKustoConnector } from "./connectors/kusto.js";
 import { makeAzureSqlConnector } from "./connectors/azureSql.js";
@@ -19,7 +20,7 @@ export function registerConnectors() {
 }
 export function buildProgram() {
     const program = new Command();
-    program.name("nexus").description("Unified Azure data access CLI").version("0.1.2");
+    program.name("nexus").description("Unified Azure data access CLI").version("0.1.3");
     registerConnectorCommand(program);
     registerQueryCommand(program);
     registerSchemaCommand(program);
@@ -27,6 +28,11 @@ export function buildProgram() {
     registerStorageAccountCommand(program);
     return program;
 }
+export function requestedFormat(argv) {
+    const i = argv.indexOf("--output");
+    const v = i >= 0 ? argv[i + 1] : undefined;
+    return v === "json" || v === "envelope" ? v : "table";
+}
 async function main() {
     registerConnectors();
     const program = buildProgram();
@@ -35,7 +41,15 @@ async function main() {
     }
     catch (e) {
         if (e instanceof ConnectorError) {
-            process.stderr.write(`error [${e.code}]: ${e.message}\n`);
+            const format = requestedFormat(process.argv);
+            if (format === "table") {
+                process.stderr.write(renderError(e.code, e.message, format) + "\n");
+            }
+            else {
+                // json/envelope: emit a self-describing { status: "error", ... } on stdout
+                // so an agent parsing a single stream can branch on `status`.
+                process.stdout.write(renderError(e.code, e.message, format) + "\n");
+            }
             process.exit(exitCodeFor(e.code));
         }
         process.stderr.write(`error: ${e.message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ascdong/nexus",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Unified Azure data access CLI for Log Analytics, Kusto, Azure SQL, and Storage Account",
   "type": "module",
   "bin": {