@astrale-os/cli 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/astrale.js

@@ -9738,7 +9738,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@astrale-os/cli",
-    version: "1.0.0-beta.6",
+    version: "1.0.0-beta.8",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -41394,6 +41394,43 @@ var init_ora = __esm(() => {
   validColors = new Set(["black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray"]);
 });
 
+// src/lib/failure-debug.ts
+function printFailureDebug(error52, url2) {
+  process.stderr.write(`
+${source_default.dim("── debug ─────────────────")}
+`);
+  if (url2)
+    process.stderr.write(`${source_default.dim(`url:   ${url2}`)}
+`);
+  const seen = new Set;
+  const pending = [{ value: error52, relation: "error" }];
+  while (pending.length > 0 && seen.size < MAXIMUM_DEBUG_FAILURES) {
+    const { value, relation } = pending.shift();
+    if (seen.has(value))
+      continue;
+    seen.add(value);
+    if (!(value instanceof Error)) {
+      process.stderr.write(`${source_default.dim(`${relation}: ${String(value)}`)}
+`);
+      continue;
+    }
+    process.stderr.write(`${source_default.dim(`${relation}: ${value.constructor.name}: ${value.message}`)}
+`);
+    if (value.stack)
+      process.stderr.write(`${source_default.dim(value.stack)}
+`);
+    if (value.cause !== undefined)
+      pending.push({ value: value.cause, relation: "caused by" });
+    if (value instanceof AggregateError)
+      for (const child3 of value.errors)
+        pending.push({ value: child3, relation: "aggregate" });
+  }
+}
+var MAXIMUM_DEBUG_FAILURES = 32;
+var init_failure_debug = __esm(() => {
+  init_source();
+});
+
 // src/lib/format.ts
 function formatElapsed(ms) {
   if (ms < 1000)
@@ -41413,11 +41450,13 @@ function fatal(e, opts) {
       payload.hint = e.hint;
     process.stderr.write(JSON.stringify(payload) + `
 `);
-    process.exit(1);
+  } else {
+    log.error(`${code}: ${msg}`);
+    if (e instanceof AstraleError && e.hint)
+      log.dim(`  hint: ${e.hint}`);
   }
-  log.error(`${code}: ${msg}`);
-  if (e instanceof AstraleError && e.hint)
-    log.dim(`  hint: ${e.hint}`);
+  if (opts?.debug)
+    printFailureDebug(e, "");
   process.exit(1);
 }
 function failInput(error52, opts) {
@@ -41490,6 +41529,7 @@ var init_log = __esm(() => {
   init_source();
   init_ora();
   init_errors2();
+  init_failure_debug();
   init_output();
   log = {
     info: (msg) => console.log(source_default.blue("ℹ"), msg),
@@ -82212,43 +82252,6 @@ var init_classify = __esm(() => {
   init_errors2();
 });
 
-// src/connection/failure/debug.ts
-function printFailureDebug(error52, url3) {
-  process.stderr.write(`
-${source_default.dim("── debug ─────────────────")}
-`);
-  if (url3)
-    process.stderr.write(`${source_default.dim(`url:   ${url3}`)}
-`);
-  const seen = new Set;
-  const pending = [{ value: error52, relation: "error" }];
-  while (pending.length > 0 && seen.size < MAXIMUM_DEBUG_FAILURES) {
-    const { value: value3, relation } = pending.shift();
-    if (seen.has(value3))
-      continue;
-    seen.add(value3);
-    if (!(value3 instanceof Error)) {
-      process.stderr.write(`${source_default.dim(`${relation}: ${String(value3)}`)}
-`);
-      continue;
-    }
-    process.stderr.write(`${source_default.dim(`${relation}: ${value3.constructor.name}: ${value3.message}`)}
-`);
-    if (value3.stack)
-      process.stderr.write(`${source_default.dim(value3.stack)}
-`);
-    if (value3.cause !== undefined)
-      pending.push({ value: value3.cause, relation: "caused by" });
-    if (value3 instanceof AggregateError)
-      for (const child3 of value3.errors)
-        pending.push({ value: child3, relation: "aggregate" });
-  }
-}
-var MAXIMUM_DEBUG_FAILURES = 32;
-var init_debug = __esm(() => {
-  init_source();
-});
-
 // src/connection/reasons.ts
 function reasonCode(reason) {
   if (!record9(reason) || typeof reason.code !== "string")
@@ -82462,8 +82465,8 @@ async function formatKernelError(error52, machine, urlArg = "", debug = false, o
     printFailureDebug(error52, urlArg);
 }
 var init_failure2 = __esm(() => {
+  init_failure_debug();
   init_classify();
-  init_debug();
   init_render2();
   init_reasons();
 });

package/dist/types/lib/failure-debug.d.ts

@@ -0,0 +1 @@
+export declare function printFailureDebug(error: unknown, url: string): void;

package/dist/types/lib/log.d.ts

@@ -10,7 +10,9 @@ export declare const log: {
 };
 /** Report an error with hint (when present) and exit. `--json` / `--ci` / a
  *  non-TTY stdout always get one structured JSON line on stderr. */
-export declare function fatal(e: unknown, opts?: MachineOpts): never;
+export declare function fatal(e: unknown, opts?: MachineOpts & {
+    readonly debug?: boolean;
+}): never;
 /** Project only a caller-authored admission failure into the CLI input family. */
 export declare function failInput(error: unknown, opts?: MachineOpts): never;
 /** Shortcut for stub commands that aren't wired in v1 (§15). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",

package/src/connection/failure/index.ts

@@ -1,7 +1,7 @@
 import type { OperationRecovery } from '../command'
 
+import { printFailureDebug } from '../../lib/failure-debug'
 import { classifyFailure } from './classify'
-import { printFailureDebug } from './debug'
 import { renderFailure } from './render'
 
 export { functionInputIssues, schemaUpgradeHint } from '../reasons'

package/src/lib/__tests__/log-errors.test.ts

@@ -36,6 +36,17 @@ describe('terminal error safety', () => {
     })
   })
 
+  test('retains unknown failure evidence only under explicit debug output', () => {
+    const failure = new AggregateError([new Error('provider rejected organization scope')], '')
+
+    expect(() => fatal(failure, { json: true, debug: true })).toThrow(ExitError)
+
+    expect(stderr).toContain(
+      '{"error":"UNEXPECTED_ERROR","message":"The CLI encountered an unexpected internal failure."}',
+    )
+    expect(stderr).toContain('aggregate: Error: provider rejected organization scope')
+  })
+
   test('rejects blank admitted CLI diagnostics', () => {
     expect(() => new AstraleError('INVALID_INPUT', '  ')).toThrow(TypeError)
   })

package/src/lib/log.ts

@@ -2,6 +2,7 @@ import chalk from 'chalk'
 import ora, { type Ora } from 'ora'
 
 import { AstraleError, NotImplementedError } from '../errors'
+import { printFailureDebug } from './failure-debug'
 import { formatElapsed } from './format'
 import { isMachine, type MachineOpts } from './output'
 
@@ -18,7 +19,7 @@ export const log = {
 
 /** Report an error with hint (when present) and exit. `--json` / `--ci` / a
  *  non-TTY stdout always get one structured JSON line on stderr. */
-export function fatal(e: unknown, opts?: MachineOpts): never {
+export function fatal(e: unknown, opts?: MachineOpts & { readonly debug?: boolean }): never {
   // Ctrl-C at an interactive (@inquirer/prompts) prompt — exit quietly with the
   // SIGINT convention, not a red error line.
   if (e instanceof Error && e.name === 'ExitPromptError') process.exit(130)
@@ -29,10 +30,11 @@ export function fatal(e: unknown, opts?: MachineOpts): never {
     const payload: Record<string, unknown> = { error: code, message: msg }
     if (e instanceof AstraleError && e.hint) payload.hint = e.hint
     process.stderr.write(JSON.stringify(payload) + '\n')
-    process.exit(1)
+  } else {
+    log.error(`${code}: ${msg}`)
+    if (e instanceof AstraleError && e.hint) log.dim(`  hint: ${e.hint}`)
   }
-  log.error(`${code}: ${msg}`)
-  if (e instanceof AstraleError && e.hint) log.dim(`  hint: ${e.hint}`)
+  if (opts?.debug) printFailureDebug(e, '')
   process.exit(1)
 }