infernoflow 0.18.0 → 0.20.0

package/dist/lib/ui/errors.mjs

@@ -0,0 +1,142 @@
+/**
+ * Shared error handling utilities for infernoflow commands.
+ *
+ * Provides consistent, friendly error messages with actionable hints.
+ */
+
+import { warn, info, bold, cyan, gray, red } from "./output.mjs";
+
+// ── Common error types ────────────────────────────────────────────────────────
+
+export const ERR = {
+  NO_INFERNO_DIR:   "inferno/ directory not found.",
+  NO_CONTRACT:      "No contract.json or capabilities.json found.",
+  NO_GIT:           "This directory is not a git repository.",
+  NO_NETWORK:       "Network request failed.",
+  INVALID_JSON:     "Invalid JSON in response.",
+  PERMISSION:       "Permission denied.",
+  TIMEOUT:          "Command timed out.",
+};
+
+// ── Error formatter ───────────────────────────────────────────────────────────
+
+export function fatalError(message, hint, jsonMode = false) {
+  if (jsonMode) {
+    console.log(JSON.stringify({ ok: false, error: message, hint: hint || undefined }));
+  } else {
+    console.error();
+    console.error(`  ${red("✗")}  ${bold(message)}`);
+    if (hint) console.error(`     ${gray(hint)}`);
+    console.error();
+  }
+  process.exit(1);
+}
+
+export function softWarn(message, hint, jsonMode = false) {
+  if (!jsonMode) {
+    warn(message);
+    if (hint) console.error(`  ${gray(hint)}`);
+  }
+}
+
+// ── Pre-flight checks ─────────────────────────────────────────────────────────
+
+import * as fs   from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+
+/**
+ * Ensure inferno/ exists. Exits with a friendly message if not.
+ */
+export function requireInfernoDir(cwd, jsonMode = false) {
+  const infernoDir = path.join(cwd, "inferno");
+  if (!fs.existsSync(infernoDir)) {
+    fatalError(
+      ERR.NO_INFERNO_DIR,
+      "Run: infernoflow init   (or: infernoflow setup  for full setup)",
+      jsonMode
+    );
+  }
+  return infernoDir;
+}
+
+/**
+ * Ensure a git repo exists. Exits with a friendly message if not.
+ */
+export function requireGitRepo(cwd, jsonMode = false) {
+  try {
+    execSync("git rev-parse --git-dir", { cwd, stdio: "ignore" });
+  } catch {
+    fatalError(
+      ERR.NO_GIT,
+      "Run: git init && git add . && git commit -m 'init'",
+      jsonMode
+    );
+  }
+}
+
+/**
+ * Read and parse a JSON file, with a friendly error on failure.
+ */
+export function readJsonFile(filePath, label, jsonMode = false) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch (err) {
+    fatalError(
+      `Could not parse ${label}: ${err.message}`,
+      `Check the file for syntax errors: ${filePath}`,
+      jsonMode
+    );
+  }
+}
+
+/**
+ * Read contract.json or capabilities.json, whichever exists.
+ */
+export function readContract(infernoDir, jsonMode = false) {
+  for (const f of ["contract.json", "capabilities.json"]) {
+    const p = path.join(infernoDir, f);
+    const data = readJsonFile(p, f, jsonMode);
+    if (data) return data;
+  }
+  fatalError(ERR.NO_CONTRACT, "Run: infernoflow init", jsonMode);
+}
+
+/**
+ * Parse a semver string. Returns { major, minor, patch } or null.
+ */
+export function parseSemver(v) {
+  const m = String(v || "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return { major: +m[1], minor: +m[2], patch: +m[3], raw: m[0] };
+}
+
+/**
+ * Validate a URL string. Returns true if valid http/https URL.
+ */
+export function isValidUrl(str) {
+  try {
+    const u = new URL(str);
+    return u.protocol === "http:" || u.protocol === "https:";
+  } catch { return false; }
+}
+
+/**
+ * Wrap an async command handler with top-level error catching.
+ * Prints a friendly message instead of a raw stack trace.
+ */
+export function withErrorHandling(fn, jsonMode = false) {
+  return fn().catch(err => {
+    if (jsonMode) {
+      console.log(JSON.stringify({ ok: false, error: err.message }));
+    } else {
+      console.error();
+      console.error(`  ${red("✗")}  ${bold("Unexpected error:")} ${err.message}`);
+      if (process.env.DEBUG) console.error(err.stack);
+      else console.error(`     ${gray("Set DEBUG=1 for a full stack trace.")}`);
+      console.error();
+    }
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infernoflow",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "The forge for liquid code - keep capabilities, contracts, and docs in sync.",
   "type": "module",
   "bin": {