@makinbakin/sdk 0.0.1-rc.22 → 0.0.1-rc.24

package/_internal/core/health/observation-builders.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Health observation builders — the ONE construction path for check
+ * output, shared by plugins (via `@makinbakin/sdk/utils`, which
+ * re-exports these) and adapter packages (which depend only on
+ * `@bakin/core`).
+ *
+ * The builders CLAMP copy to the health contract's bounds instead of
+ * letting an overlong or blank string invalidate the whole run: a check
+ * that interpolated a long runtime error into its summary used to fail
+ * contract validation wholesale, turning real evidence into a useless
+ * "could not be verified" card (field-diagnosed 2026-07-22). Truncated
+ * copy is honest; discarded evidence is not. Constructing observations
+ * as raw object literals bypasses this protection — always build through
+ * these helpers.
+ */
+import type { ErrorObservationInput, HealthNonEmptyArray, HealthObservationInput, HealthyObservationInput, NotApplicableHealthCheckRunInput, ObservedHealthCheckRunInput, UnknownObservationInput, WarningObservationInput } from '../plugin-types';
+type HealthyObservationFields = Omit<HealthyObservationInput, 'status'>;
+type WarningObservationFields = Omit<WarningObservationInput, 'status'>;
+type ErrorObservationFields = Omit<ErrorObservationInput, 'status'>;
+type UnknownObservationFields = Omit<UnknownObservationInput, 'status'>;
+/** Build a healthy observation. Healthy observations cannot carry incidents. */
+export declare function healthHealthy(input: HealthyObservationFields): HealthyObservationInput;
+/** Build a warning observation with an explicit advisory/watch/action disposition. */
+export declare function healthWarning(input: WarningObservationFields): WarningObservationInput;
+/** Build an error observation. Its incident must require operator action. */
+export declare function healthError(input: ErrorObservationFields): ErrorObservationInput;
+/** Build an Unknown verification observation (watch, or advisory when it self-resolves). */
+export declare function healthUnknown(input: UnknownObservationFields): UnknownObservationInput;
+/** Build a successful observed run. Empty diagnostic output is unrepresentable. */
+export declare function healthObserved(observations: HealthNonEmptyArray<HealthObservationInput>): ObservedHealthCheckRunInput;
+/** Build an explicit successful not-applicable run. */
+export declare function healthNotApplicable(reason: string): NotApplicableHealthCheckRunInput;
+export {};

package/_internal/core/plugin-types.d.ts

@@ -231,7 +231,7 @@ export interface NotificationChannelDef extends PluginNotificationChannelInput {
     /** Set when runtime === 'plugin'; identifies the owning plugin. */
     pluginId?: string;
 }
-export type { ActionIncidentInput, AdvisoryIncidentInput, CanonicalErrorObservation, CanonicalHealthyObservation, CanonicalUnknownObservation, CanonicalWarningObservation, ErrorObservationInput, HealthCheckExecution, HealthCheckRegistrationInput, HealthCheckRunContext, HealthCheckRunInput, HealthCheckSnapshot, HealthCheckState, HealthDisposition, HealthFullSweep, HealthGroup, HealthIncident, HealthIncidentInput, HealthInstructionsResolution, HealthNavigateResolution, HealthNonEmptyArray, HealthObservation, HealthObservationInput, HealthObservationStatus, HealthOwner, HealthOwnerKind, HealthRepairActionDefinition, HealthRepairApplyRequest, HealthRepairApplyResult, HealthRepairSafety, HealthRepairChange, HealthRepairPlanItem, HealthRepairPlan, HealthRepairPrecondition, HealthRepairResolution, HealthRepairTarget, HealthReport, HealthReportStatus, HealthReportSummary, HealthResolution, HealthResource, HealthResourceKind, HealthRerunResolution, HealthyObservationInput, JsonObject, JsonValue, SearchReadiness, SearchReadinessStage, SearchReadinessStageKey, SearchReadinessStatus, SearchStageStatus, UnknownObservationInput, WarningObservationInput, WatchIncidentInput, } from '@makinbakin/sdk/types';
+export type { ActionIncidentInput, AdvisoryIncidentInput, CanonicalErrorObservation, CanonicalHealthyObservation, CanonicalUnknownObservation, CanonicalWarningObservation, ErrorObservationInput, HealthCheckExecution, HealthCheckRegistrationInput, HealthCheckRunContext, HealthCheckRunInput, HealthCheckSnapshot, HealthCheckState, HealthDisposition, HealthFullSweep, HealthGroup, HealthIncident, HealthIncidentInput, HealthInstructionsResolution, HealthNavigateResolution, HealthNonEmptyArray, HealthObservation, HealthObservationInput, HealthObservationStatus, HealthOwner, HealthOwnerKind, HealthRepairActionDefinition, HealthRepairApplyRequest, HealthRepairApplyResult, HealthRepairSafety, HealthRepairChange, HealthRepairPlanItem, HealthRepairPlan, HealthRepairPrecondition, HealthRepairResolution, HealthRepairTarget, HealthReport, HealthReportStatus, HealthReportSummary, HealthResolution, HealthResource, HealthResourceKind, HealthRerunResolution, HealthyObservationInput, JsonObject, JsonValue, NotApplicableHealthCheckRunInput, ObservedHealthCheckRunInput, SearchReadiness, SearchReadinessStage, SearchReadinessStageKey, SearchReadinessStatus, SearchStageStatus, UnknownObservationInput, WarningObservationInput, WatchIncidentInput, } from '@makinbakin/sdk/types';
 /** Core-internal canonical registration with its resolved owner and local id. */
 export interface HealthCheckDef extends HealthCheckRegistrationInput {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makinbakin/sdk",
-  "version": "0.0.1-rc.22",
+  "version": "0.0.1-rc.24",
   "description": "SDK for building Bakin plugins — UI components, slot types, hooks, and the runtime registerPlugin helper.",
   "type": "module",
   "sideEffects": false,

package/utils/index.d.ts

@@ -5,23 +5,7 @@
  * needs. The `format*` helpers are re-exported from `@bakin/core/format`
  * so plugins have a single import path instead of reaching into `@/lib/*`.
  */
-import type { ErrorObservationInput, HealthNonEmptyArray, HealthObservationInput, HealthyObservationInput, NotApplicableHealthCheckRunInput, ObservedHealthCheckRunInput, UnknownObservationInput, WarningObservationInput } from '../types/index';
-type HealthyObservationFields = Omit<HealthyObservationInput, 'status'>;
-type WarningObservationFields = Omit<WarningObservationInput, 'status'>;
-type ErrorObservationFields = Omit<ErrorObservationInput, 'status'>;
-type UnknownObservationFields = Omit<UnknownObservationInput, 'status'>;
-/** Build a healthy observation. Healthy observations cannot carry incidents. */
-export declare function healthHealthy(input: HealthyObservationFields): HealthyObservationInput;
-/** Build a warning observation with an explicit advisory/watch/action disposition. */
-export declare function healthWarning(input: WarningObservationFields): WarningObservationInput;
-/** Build an error observation. Its incident must require operator action. */
-export declare function healthError(input: ErrorObservationFields): ErrorObservationInput;
-/** Build an Unknown verification observation with a watch disposition. */
-export declare function healthUnknown(input: UnknownObservationFields): UnknownObservationInput;
-/** Build a successful observed run. Empty diagnostic output is unrepresentable. */
-export declare function healthObserved(observations: HealthNonEmptyArray<HealthObservationInput>): ObservedHealthCheckRunInput;
-/** Build an explicit successful not-applicable run. */
-export declare function healthNotApplicable(reason: string): NotApplicableHealthCheckRunInput;
+export { healthError, healthHealthy, healthNotApplicable, healthObserved, healthUnknown, healthWarning, } from '../_internal/core/health/observation-builders';
 /** Tailwind class merger (clsx + tailwind-merge). */
 export { cn } from '../_internal/app/lib/utils';
 /** Semantic tone for an outline status badge. */

package/utils/index.js

@@ -1,4 +1,52 @@
 // @bun
+// packages/core/src/health/observation-builders.ts
+var SUMMARY_MAX = 500;
+var DETAIL_MAX = 4000;
+var IMPACT_MAX = 500;
+function truncate(value, max) {
+  if (value.length <= max)
+    return value;
+  let end = max - 1;
+  const last = value.charCodeAt(end - 1);
+  if (last >= 55296 && last <= 56319)
+    end -= 1;
+  return `${value.slice(0, end)}\u2026`;
+}
+function clampCopy(input) {
+  const clamped = { ...input };
+  const summary = clamped.summary.trim();
+  clamped.summary = truncate(summary.length > 0 ? summary : "(no summary provided)", SUMMARY_MAX);
+  if (clamped.detail !== undefined) {
+    const detail = clamped.detail.trim();
+    if (detail.length === 0) {
+      delete clamped.detail;
+    } else {
+      clamped.detail = truncate(detail, DETAIL_MAX);
+    }
+  }
+  if (clamped.incident && clamped.incident.impact.length > IMPACT_MAX) {
+    clamped.incident = { ...clamped.incident, impact: truncate(clamped.incident.impact, IMPACT_MAX) };
+  }
+  return clamped;
+}
+function healthHealthy(input) {
+  return { ...clampCopy(input), status: "healthy" };
+}
+function healthWarning(input) {
+  return { ...clampCopy(input), status: "warning" };
+}
+function healthError(input) {
+  return { ...clampCopy(input), status: "error" };
+}
+function healthUnknown(input) {
+  return { ...clampCopy(input), status: "unknown" };
+}
+function healthObserved(observations) {
+  return { outcome: "observed", observations };
+}
+function healthNotApplicable(reason) {
+  return { outcome: "not_applicable", reason };
+}
 // node_modules/.bun/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
@@ -2116,24 +2164,6 @@ function pluginFetch(pluginId, path, init) {
 }
 
 // packages/sdk/src/utils/index.ts
-function healthHealthy(input) {
-  return { ...input, status: "healthy" };
-}
-function healthWarning(input) {
-  return { ...input, status: "warning" };
-}
-function healthError(input) {
-  return { ...input, status: "error" };
-}
-function healthUnknown(input) {
-  return { ...input, status: "unknown" };
-}
-function healthObserved(observations) {
-  return { outcome: "observed", observations };
-}
-function healthNotApplicable(reason) {
-  return { outcome: "not_applicable", reason };
-}
 var TONE_BADGE_CLASS = {
   success: "bg-green-500/10 text-green-400 border-green-500/20",
   pending: "bg-amber-500/10 text-amber-400 border-amber-500/20",