@alavida/agentpack 0.1.1

package/src/utils/errors.js

@@ -0,0 +1,67 @@
+/**
+ * Structured error codes matching the CLI design reference exit code map.
+ */
+export const EXIT_CODES = {
+  SUCCESS: 0,
+  GENERAL: 1,
+  VALIDATION: 2,
+  NETWORK: 3,
+  NOT_FOUND: 4,
+};
+
+/**
+ * Base error class for all agentpack CLI errors.
+ * Carries a machine-readable code and mapped exit code.
+ */
+export class AgentpackError extends Error {
+  constructor(message, { code, exitCode = EXIT_CODES.GENERAL, suggestion } = {}) {
+    super(message);
+    this.name = 'AgentpackError';
+    this.code = code || 'general_error';
+    this.exitCode = exitCode;
+    this.suggestion = suggestion;
+  }
+
+  toJSON() {
+    return {
+      error: this.code,
+      message: this.message,
+      ...(this.suggestion && { suggestion: this.suggestion }),
+    };
+  }
+}
+
+export class ValidationError extends AgentpackError {
+  constructor(message, opts = {}) {
+    super(message, { code: 'validation_error', exitCode: EXIT_CODES.VALIDATION, ...opts });
+    this.name = 'ValidationError';
+  }
+}
+
+export class NetworkError extends AgentpackError {
+  constructor(message, opts = {}) {
+    super(message, { code: 'network_error', exitCode: EXIT_CODES.NETWORK, ...opts });
+    this.name = 'NetworkError';
+  }
+}
+
+export class NotFoundError extends AgentpackError {
+  constructor(message, opts = {}) {
+    super(message, { code: 'not_found', exitCode: EXIT_CODES.NOT_FOUND, ...opts });
+    this.name = 'NotFoundError';
+  }
+}
+
+/**
+ * Format an error for human-readable stderr output.
+ */
+export function formatError(err) {
+  if (err instanceof AgentpackError) {
+    let msg = `Error: ${err.message}`;
+    if (err.suggestion) {
+      msg += `\n\nSuggestion: ${err.suggestion}`;
+    }
+    return msg;
+  }
+  return `Error: ${err.message || err}`;
+}

package/src/utils/output.js

@@ -0,0 +1,61 @@
+import { stdout, stderr } from 'node:process';
+
+/**
+ * TTY detection: humans get formatted output, agents get JSON.
+ * --json flag overrides TTY detection (always JSON).
+ * --quiet suppresses non-essential stderr.
+ */
+
+const isTTY = stdout.isTTY === true;
+const supportsColor = isTTY && !process.env.NO_COLOR;
+
+export const output = {
+  /**
+   * Write primary results to stdout.
+   */
+  write(text) {
+    stdout.write(text + '\n');
+  },
+
+  /**
+   * Write JSON to stdout. Used when --json flag is set or piping.
+   */
+  json(data) {
+    stdout.write(JSON.stringify(data, null, 2) + '\n');
+  },
+
+  /**
+   * Write status/progress to stderr (visible to humans, invisible to pipes).
+   */
+  status(text) {
+    stderr.write(text + '\n');
+  },
+
+  /**
+   * Write error to stderr.
+   */
+  error(text) {
+    stderr.write(text + '\n');
+  },
+
+  /**
+   * Write a table to stdout for human-readable output.
+   */
+  table(headers, rows) {
+    const widths = headers.map((h, i) =>
+      Math.max(h.length, ...rows.map((r) => String(r[i] || '').length))
+    );
+
+    const pad = (str, width) => String(str).padEnd(width);
+    const sep = widths.map((w) => '-'.repeat(w)).join('  ');
+
+    stdout.write(headers.map((h, i) => pad(h, widths[i])).join('  ') + '\n');
+    stdout.write(sep + '\n');
+    for (const row of rows) {
+      stdout.write(row.map((c, i) => pad(c || '', widths[i])).join('  ') + '\n');
+    }
+  },
+
+  isTTY,
+  supportsColor,
+};