@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/dist/telemetry/prometheus/index.d.ts

@@ -1,7 +1,7 @@
 import { F as FulmenError } from '../../fulmen-error-B_kX8jSC.js';
 import { metrics } from '../index.js';
 import { b as MetricsRegistry } from '../../registry-_yEKhTTl.js';
-import { S as SignalManager } from '../../manager-D27vrdaS.js';
+import { S as SignalManager } from '../../manager-CH3fX7zO.js';
 import { IncomingMessage, ServerResponse, Server } from 'node:http';
 import '../../types-BJswWpQC.js';
 

package/dist/telemetry/prometheus/index.js

@@ -1610,7 +1610,10 @@ async function loadReferencedSchema(uri) {
   const repoRoot = join(__dirname4, "..", "..");
   let resolvedPath;
   if (uri.startsWith("https://schemas.fulmenhq.dev/")) {
-    const relativePath = uri.replace("https://schemas.fulmenhq.dev/", "");
+    let relativePath = uri.replace("https://schemas.fulmenhq.dev/", "");
+    if (relativePath.startsWith("crucible/")) {
+      relativePath = relativePath.slice("crucible/".length);
+    }
     if (relativePath.startsWith("config/taxonomy/")) {
       resolvedPath = join(
         repoRoot,
@@ -1827,7 +1830,9 @@ async function compileSchemaById(schemaId, registryOptions) {
     const aliases = [];
     const normalizedRelativePath = metadata.relativePath.replace(/\\/g, "/");
     if (normalizedRelativePath) {
-      aliases.push(new URL(normalizedRelativePath, "https://schemas.fulmenhq.dev/").toString());
+      aliases.push(
+        new URL(`crucible/${normalizedRelativePath}`, "https://schemas.fulmenhq.dev/").toString()
+      );
     }
     return compileSchema(content, { aliases });
   } catch (error) {
@@ -2345,6 +2350,12 @@ var init_exitCodes = __esm({
       EXIT_TEST_USAGE_ERROR: 94,
       EXIT_TEST_NO_TESTS_COLLECTED: 95,
       EXIT_COVERAGE_THRESHOLD_NOT_MET: 96,
+      // Shell & Process Control (124-127)
+      // Exit codes from shell conventions and process control utilities (timeout, exec)
+      EXIT_TIMEOUT: 124,
+      EXIT_TIMEOUT_INTERNAL: 125,
+      EXIT_CANNOT_EXECUTE: 126,
+      EXIT_NOT_FOUND: 127,
       // Signal-Induced Exits (128-165)
       // Process terminated by Unix signals (128+N pattern per POSIX). Signal codes follow Linux numbering; macOS/FreeBSD differ for SIGUSR1/SIGUSR2. For full signal semantics, see config/library/foundry/signals.yaml. For signal handling patterns, see docs/standards/library/modules/signal-handling.md.
       EXIT_SIGNAL_HUP: 129,
@@ -2682,6 +2693,36 @@ var init_exitCodes = __esm({
         context: "Code coverage validation, quality gate failure",
         category: "testing"
       },
+      124: {
+        code: 124,
+        name: "EXIT_TIMEOUT",
+        description: "Command timed out before completion",
+        context: "GNU timeout or similar utility terminated command after deadline",
+        category: "shell"
+      },
+      125: {
+        code: 125,
+        name: "EXIT_TIMEOUT_INTERNAL",
+        description: "Timeout utility itself failed",
+        context: "Error in timeout tool before or during command execution (not command failure)",
+        category: "shell"
+      },
+      126: {
+        code: 126,
+        name: "EXIT_CANNOT_EXECUTE",
+        description: "Command found but could not be executed",
+        context: "Permission denied, not executable, exec format error",
+        category: "shell",
+        bsdEquivalent: "EX_NOPERM (partial)"
+      },
+      127: {
+        code: 127,
+        name: "EXIT_NOT_FOUND",
+        description: "Command not found",
+        context: "Executable not found in PATH or specified path does not exist",
+        category: "shell",
+        bsdEquivalent: "EX_UNAVAILABLE (partial)"
+      },
       129: {
         code: 129,
         name: "EXIT_SIGNAL_HUP",
@@ -4995,6 +5036,45 @@ ${cause.message}`;
 ${cause.message}`;
         return new _AppIdentityError(message, path, cause);
       }
+      /**
+       * Create error for embedded identity already registered
+       *
+       * Uses first-wins semantics - once registered, cannot be replaced
+       */
+      static alreadyRegistered() {
+        const message = "Embedded identity already registered. Registration uses first-wins semantics and cannot be replaced.";
+        return new _AppIdentityError(message);
+      }
+      /**
+       * Create error for embedded identity YAML parsing failure
+       */
+      static embeddedParseFailed(cause) {
+        const message = `Failed to parse embedded identity YAML: ${cause.message}`;
+        return new _AppIdentityError(message, void 0, cause);
+      }
+      /**
+       * Create error for embedded identity schema validation failure
+       */
+      static embeddedValidationFailed(diagnostics) {
+        const errorCount = diagnostics.filter((d) => d.severity === "ERROR").length;
+        const warningCount = diagnostics.filter((d) => d.severity === "WARN").length;
+        let message = "Invalid embedded identity\n";
+        message += `Validation errors: ${errorCount} error(s), ${warningCount} warning(s)
+`;
+        const displayDiagnostics = diagnostics.slice(0, 3);
+        for (const diag3 of displayDiagnostics) {
+          message += `  - ${diag3.message}`;
+          if (diag3.pointer) {
+            message += ` at ${diag3.pointer}`;
+          }
+          message += "\n";
+        }
+        if (diagnostics.length > 3) {
+          message += `  ... and ${diagnostics.length - 3} more
+`;
+        }
+        return new _AppIdentityError(message);
+      }
     };
   }
 });
@@ -5052,6 +5132,65 @@ var init_discovery = __esm({
     init_errors4();
   }
 });
+function deepFreeze5(obj) {
+  Object.freeze(obj);
+  Object.getOwnPropertyNames(obj).forEach((prop) => {
+    const value = obj[prop];
+    if (value !== null && (typeof value === "object" || typeof value === "function") && !Object.isFrozen(value)) {
+      deepFreeze5(value);
+    }
+  });
+  return obj;
+}
+async function registerEmbeddedIdentity(data) {
+  if (isRegistered) {
+    throw AppIdentityError.alreadyRegistered();
+  }
+  let identity;
+  if (typeof data === "string") {
+    let parsed;
+    try {
+      parsed = parse(data);
+    } catch (error) {
+      throw AppIdentityError.embeddedParseFailed(
+        error instanceof Error ? error : new Error(String(error))
+      );
+    }
+    const result = await validateDataBySchemaId(parsed, APP_IDENTITY_SCHEMA_ID);
+    if (!result.valid) {
+      throw AppIdentityError.embeddedValidationFailed(result.diagnostics);
+    }
+    identity = parsed;
+  } else {
+    const result = await validateDataBySchemaId(data, APP_IDENTITY_SCHEMA_ID);
+    if (!result.valid) {
+      throw AppIdentityError.embeddedValidationFailed(result.diagnostics);
+    }
+    identity = data;
+  }
+  embeddedIdentity = deepFreeze5(structuredClone(identity));
+  isRegistered = true;
+}
+function hasEmbeddedIdentity() {
+  return isRegistered;
+}
+function getEmbeddedIdentity() {
+  return embeddedIdentity;
+}
+function clearEmbeddedIdentity() {
+  embeddedIdentity = null;
+  isRegistered = false;
+}
+var embeddedIdentity, isRegistered;
+var init_embedded = __esm({
+  "src/appidentity/embedded.ts"() {
+    init_schema();
+    init_constants();
+    init_errors4();
+    embeddedIdentity = null;
+    isRegistered = false;
+  }
+});
 
 // src/appidentity/loader.ts
 var loader_exports = {};
@@ -5060,19 +5199,19 @@ __export(loader_exports, {
   getCachedIdentity: () => getCachedIdentity,
   loadIdentity: () => loadIdentity
 });
-function deepFreeze5(obj) {
+function deepFreeze6(obj) {
   Object.freeze(obj);
   Object.getOwnPropertyNames(obj).forEach((prop) => {
     const value = obj[prop];
     if (value !== null && (typeof value === "object" || typeof value === "function") && !Object.isFrozen(value)) {
-      deepFreeze5(value);
+      deepFreeze6(value);
     }
   });
   return obj;
 }
 async function loadIdentity(options) {
   if (options?.identity) {
-    return deepFreeze5(structuredClone(options.identity));
+    return deepFreeze6(structuredClone(options.identity));
   }
   if (!options?.skipCache) {
     const cached = getCachedIdentity();
@@ -5080,11 +5219,30 @@ async function loadIdentity(options) {
       return cached;
     }
   }
-  const discovery = await discoverIdentityPath({
-    path: options?.path,
-    startDir: options?.startDir
-  });
+  let discovery;
+  try {
+    discovery = await discoverIdentityPath({
+      path: options?.path,
+      startDir: options?.startDir
+    });
+  } catch (error) {
+    const hasExplicitPath = Boolean(options?.path);
+    const hasEnvOverride = Boolean(process.env[APP_IDENTITY_ENV_VAR]);
+    if (!hasExplicitPath && !hasEnvOverride && error instanceof AppIdentityError) {
+      const embedded = getEmbeddedIdentity();
+      if (embedded) {
+        setCachedIdentity(embedded);
+        return embedded;
+      }
+    }
+    throw error;
+  }
   if (!discovery) {
+    const embedded = getEmbeddedIdentity();
+    if (embedded) {
+      setCachedIdentity(embedded);
+      return embedded;
+    }
     throw AppIdentityError.notFound([]);
   }
   let content;
@@ -5111,7 +5269,7 @@ async function loadIdentity(options) {
       throw AppIdentityError.validationFailed(discovery.path, result.diagnostics);
     }
   }
-  const identity = deepFreeze5(structuredClone(parsed));
+  const identity = deepFreeze6(structuredClone(parsed));
   setCachedIdentity(identity);
   return identity;
 }
@@ -5121,6 +5279,7 @@ var init_loader2 = __esm({
     init_cache();
     init_constants();
     init_discovery();
+    init_embedded();
     init_errors4();
   }
 });
@@ -10555,20 +10714,25 @@ __export(appidentity_exports, {
   AppIdentityError: () => AppIdentityError,
   MAX_ANCESTOR_SEARCH_DEPTH: () => MAX_ANCESTOR_SEARCH_DEPTH,
   buildEnvVar: () => buildEnvVar,
+  clearEmbeddedIdentity: () => clearEmbeddedIdentity,
   clearIdentityCache: () => clearIdentityCache,
   getBinaryName: () => getBinaryName,
   getCachedIdentity: () => getCachedIdentity,
   getConfigIdentifiers: () => getConfigIdentifiers,
   getConfigName: () => getConfigName,
+  getEmbeddedIdentity: () => getEmbeddedIdentity,
   getEnvPrefix: () => getEnvPrefix,
   getEnvVar: () => getEnvVar,
   getTelemetryNamespace: () => getTelemetryNamespace,
   getVendor: () => getVendor,
-  loadIdentity: () => loadIdentity
+  hasEmbeddedIdentity: () => hasEmbeddedIdentity,
+  loadIdentity: () => loadIdentity,
+  registerEmbeddedIdentity: () => registerEmbeddedIdentity
 });
 var init_appidentity = __esm({
   "src/appidentity/index.ts"() {
     init_constants();
+    init_embedded();
     init_errors4();
     init_helpers();
     init_loader2();