harnery 0.35.0 → 0.36.0

package/src/core/storage/health.ts

@@ -0,0 +1,76 @@
+import {
+  HARNERY_STORAGE_HEALTH_SCHEMA,
+  type HarneryStorageFamilyHealth,
+  type HarneryStorageHealthReport,
+  type HarneryStorageInventoryReport,
+} from "./contract.ts";
+
+const DEGRADED_REASONS = new Set<string>([
+  "hard_link_ambiguous",
+  "overlapping_registration",
+  "special_file_rejected",
+  "symlink_rejected",
+  "unreadable_path",
+  "wrong_root_type",
+]);
+
+/** Project a read-only inventory into reason-coded health without probing bodies. */
+export function storageHealth(
+  inventory: HarneryStorageInventoryReport,
+): HarneryStorageHealthReport {
+  const families = inventory.families.map(familyHealth);
+  const issueReasons = inventory.issues.map(({ reason_code }) => reason_code);
+  const reasons = new Set<string>(issueReasons);
+  for (const family of families) for (const reason of family.reason_codes) reasons.add(reason);
+  const status =
+    issueReasons.some((reason) => DEGRADED_REASONS.has(reason)) ||
+    families.some((family) => family.status === "degraded")
+      ? "degraded"
+      : issueReasons.length > 0 || families.some((family) => family.status === "unknown")
+        ? "unknown"
+        : "healthy";
+  return {
+    schema: HARNERY_STORAGE_HEALTH_SCHEMA,
+    captured_at: inventory.captured_at,
+    inventory_schema: inventory.schema,
+    status,
+    reason_codes: [...reasons].sort(),
+    families,
+    issues: inventory.issues,
+  };
+}
+
+function familyHealth(
+  family: HarneryStorageInventoryReport["families"][number],
+): HarneryStorageFamilyHealth {
+  const reasons = new Set<string>(family.reason_codes);
+  if (family.state === "delegated") reasons.add("delegated_inventory_unavailable");
+  if (family.state === "dormant") reasons.add("root_dormant");
+  for (const reason of family.log_storage?.retention.reason_codes ?? []) reasons.add(reason);
+  const degraded = [...reasons].some((reason) => DEGRADED_REASONS.has(reason));
+  const logDegraded =
+    family.log_storage?.pressure.state === "over_budget" ||
+    family.log_storage?.retention.state === "blocked";
+  const logUnknown =
+    family.log_storage?.pressure.state === "unknown" ||
+    family.log_storage?.retention.state === "unmanaged";
+  return {
+    family_id: family.family_id,
+    policy_version: family.policy_version,
+    status:
+      degraded || logDegraded
+        ? "degraded"
+        : family.state === "dormant" ||
+            family.state === "delegated" ||
+            family.state === "unavailable" ||
+            family.reason_codes.includes("allocated_bytes_unavailable") ||
+            logUnknown
+          ? "unknown"
+          : family.state === "partial"
+            ? "unknown"
+            : "healthy",
+    reason_codes: [...reasons].sort(),
+    maintenance: family.maintenance,
+    ...(family.log_storage ? { log_storage: family.log_storage } : {}),
+  };
+}

package/src/core/storage/index.ts

@@ -0,0 +1,15 @@
+export * from "./builtins.ts";
+export * from "./catalog.ts";
+export * from "./config.ts";
+export * from "./contract.ts";
+export * from "./durable-history.ts";
+export * from "./health.ts";
+export * from "./inventory.ts";
+export * from "./log-retention.ts";
+export * from "./logger.ts";
+export * from "./maintenance.ts";
+export * from "./maintenance-providers.ts";
+export * from "./policy.ts";
+export * from "./query.ts";
+export * from "./receipts.ts";
+export * from "./sink-graph.ts";