@foresthubai/workflow-builder 0.4.3 → 0.4.5

package/src/stores/debugStore.ts

@@ -1,74 +1,78 @@
-import { create } from "zustand";
-
-// ---------------------------------------------------------------------------
-// Session Phase State Machine
-// ---------------------------------------------------------------------------
-
-export type DebugSessionPhase =
-  | { status: "inactive" }
-  | { status: "building"; abortController: AbortController }
-  | { status: "idle"; sessionId: string }
-  | { status: "paused"; sessionId: string; cursorNodeId: string }
-  | { status: "stepping"; sessionId: string; cursorNodeId: string }
-  | { status: "error"; message: string };
-
-// ---------------------------------------------------------------------------
-// Console
-// ---------------------------------------------------------------------------
-
-export interface ConsoleEntry {
-  id: number;
-  timestamp: number;
-  type: "message" | "error" | "system";
-  text: string;
-}
-
-// ---------------------------------------------------------------------------
-// Store
-// ---------------------------------------------------------------------------
-
-interface DebugState {
-  phase: DebugSessionPhase;
-  /** Workflow variable values — client-owned, sent with each step request */
-  context: Record<string, unknown>;
-  console: ConsoleEntry[];
-  nextConsoleId: number;
-
-  // Actions
-  setPhase: (phase: DebugSessionPhase) => void;
-  setContext: (ctx: Record<string, unknown>) => void;
-  updateContextVar: (key: string, value: unknown) => void;
-  appendConsole: (type: ConsoleEntry["type"], text: string) => void;
-  clearConsole: () => void;
-  reset: () => void;
-}
-
-export const useDebugStore = create<DebugState>((set) => ({
-  phase: { status: "inactive" },
-  context: {},
-  console: [],
-  nextConsoleId: 0,
-
-  setPhase: (phase) => set({ phase }),
-
-  setContext: (ctx) => set({ context: ctx }),
-
-  updateContextVar: (key, value) =>
-    set((s) => ({ context: { ...s.context, [key]: value } })),
-
-  appendConsole: (type, text) =>
-    set((s) => ({
-      console: [...s.console, { id: s.nextConsoleId, timestamp: Date.now(), type, text }],
-      nextConsoleId: s.nextConsoleId + 1,
-    })),
-
-  clearConsole: () => set({ console: [], nextConsoleId: 0 }),
-
-  reset: () =>
-    set({
-      phase: { status: "inactive" },
-      context: {},
-      console: [],
-      nextConsoleId: 0,
-    }),
-}));
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
+import { create } from "zustand";
+
+// ---------------------------------------------------------------------------
+// Session Phase State Machine
+// ---------------------------------------------------------------------------
+
+export type DebugSessionPhase =
+  | { status: "inactive" }
+  | { status: "building"; abortController: AbortController }
+  | { status: "idle"; sessionId: string }
+  | { status: "paused"; sessionId: string; cursorNodeId: string }
+  | { status: "stepping"; sessionId: string; cursorNodeId: string }
+  | { status: "error"; message: string };
+
+// ---------------------------------------------------------------------------
+// Console
+// ---------------------------------------------------------------------------
+
+export interface ConsoleEntry {
+  id: number;
+  timestamp: number;
+  type: "message" | "error" | "system";
+  text: string;
+}
+
+// ---------------------------------------------------------------------------
+// Store
+// ---------------------------------------------------------------------------
+
+interface DebugState {
+  phase: DebugSessionPhase;
+  /** Workflow variable values — client-owned, sent with each step request */
+  context: Record<string, unknown>;
+  console: ConsoleEntry[];
+  nextConsoleId: number;
+
+  // Actions
+  setPhase: (phase: DebugSessionPhase) => void;
+  setContext: (ctx: Record<string, unknown>) => void;
+  updateContextVar: (key: string, value: unknown) => void;
+  appendConsole: (type: ConsoleEntry["type"], text: string) => void;
+  clearConsole: () => void;
+  reset: () => void;
+}
+
+export const useDebugStore = create<DebugState>((set) => ({
+  phase: { status: "inactive" },
+  context: {},
+  console: [],
+  nextConsoleId: 0,
+
+  setPhase: (phase) => set({ phase }),
+
+  setContext: (ctx) => set({ context: ctx }),
+
+  updateContextVar: (key, value) =>
+    set((s) => ({ context: { ...s.context, [key]: value } })),
+
+  appendConsole: (type, text) =>
+    set((s) => ({
+      console: [...s.console, { id: s.nextConsoleId, timestamp: Date.now(), type, text }],
+      nextConsoleId: s.nextConsoleId + 1,
+    })),
+
+  clearConsole: () => set({ console: [], nextConsoleId: 0 }),
+
+  reset: () =>
+    set({
+      phase: { status: "inactive" },
+      context: {},
+      console: [],
+      nextConsoleId: 0,
+    }),
+}));

package/src/stores/diagnosticsStore.ts

@@ -1,130 +1,134 @@
-/**
- * diagnosticsStore.ts
- *
- * This Zustand store manages diagnostics (errors and warnings) for the currently active canvas
- * in the workflow builder. It holds diagnostics for nodes and edges, keyed by their IDs.
- *
- * Key design points:
- * - Only diagnostics for the active canvas are stored (flat, not per-canvas).
- * - Diagnostics are written by node/edge components via useEffect, and cleared on unmount.
- * - On canvas switch, the store is cleared and repopulated for the new canvas.
- * - Used for real-time UI feedback (badges, warnings) in the workflow builder.
- * - For full-project validation (e.g., before code generation), use validateAllCanvases() in utils/diagnostics.ts.
- *
- * See docs/diagnostics.md for full architecture and lifecycle details.
- */
-import { create } from "zustand";
-import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
-
-interface DiagnosticsState {
-  byNodeId: Record<string, Diagnostic[]>;
-  byEdgeId: Record<string, Diagnostic[]>;
-  /**
-   * Channels are project-scoped, not canvas-scoped, so this slot lives
-   * here regardless of the active canvas. Written by ChannelDiagnosticsSync,
-   * which is mounted once at the workflow builder root.
-   */
-  byChannelId: Record<string, Diagnostic[]>;
-  /**
-   * Memory primitives are project-scoped like channels. Written by
-   * MemoryDiagnosticsSync, mounted once at the workflow builder root.
-   */
-  byMemoryId: Record<string, Diagnostic[]>;
-  /**
-   * Declared models are project-scoped like channels/memory. Written by
-   * ModelDiagnosticsSync, mounted once at the workflow builder root.
-   */
-  byModelId: Record<string, Diagnostic[]>;
-  /**
-   * Functions are project-scoped declarations. Keyed by function id. Written by
-   * the resource diagnostics sync, mounted once at the workflow builder root.
-   */
-  byFunctionId: Record<string, Diagnostic[]>;
-  setNodeDiagnostics: (nodeId: string, diags: Diagnostic[]) => void;
-  clearNodeDiagnostics: (nodeId: string) => void;
-  setEdgeDiagnostics: (edgeId: string, diags: Diagnostic[]) => void;
-  clearEdgeDiagnostics: (edgeId: string) => void;
-  setChannelDiagnostics: (channelId: string, diags: Diagnostic[]) => void;
-  clearChannelDiagnostics: (channelId: string) => void;
-  setMemoryDiagnostics: (memoryId: string, diags: Diagnostic[]) => void;
-  clearMemoryDiagnostics: (memoryId: string) => void;
-  setModelDiagnostics: (modelId: string, diags: Diagnostic[]) => void;
-  clearModelDiagnostics: (modelId: string) => void;
-  setFunctionDiagnostics: (functionId: string, diags: Diagnostic[]) => void;
-  clearFunctionDiagnostics: (functionId: string) => void;
-}
-
-export const useDiagnosticsStore = create<DiagnosticsState>((set) => ({
-  byNodeId: {},
-  byEdgeId: {},
-  byChannelId: {},
-  byMemoryId: {},
-  byModelId: {},
-  byFunctionId: {},
-
-  setNodeDiagnostics: (nodeId, diags) =>
-    set((state) => ({
-      byNodeId: { ...state.byNodeId, [nodeId]: diags },
-    })),
-
-  clearNodeDiagnostics: (nodeId) =>
-    set((state) => {
-      const { [nodeId]: _, ...rest } = state.byNodeId;
-      return { byNodeId: rest };
-    }),
-
-  setEdgeDiagnostics: (edgeId, diags) =>
-    set((state) => ({
-      byEdgeId: { ...state.byEdgeId, [edgeId]: diags },
-    })),
-
-  clearEdgeDiagnostics: (edgeId) =>
-    set((state) => {
-      const { [edgeId]: _, ...rest } = state.byEdgeId;
-      return { byEdgeId: rest };
-    }),
-
-  setChannelDiagnostics: (channelId, diags) =>
-    set((state) => ({
-      byChannelId: { ...state.byChannelId, [channelId]: diags },
-    })),
-
-  clearChannelDiagnostics: (channelId) =>
-    set((state) => {
-      const { [channelId]: _, ...rest } = state.byChannelId;
-      return { byChannelId: rest };
-    }),
-
-  setMemoryDiagnostics: (memoryId, diags) =>
-    set((state) => ({
-      byMemoryId: { ...state.byMemoryId, [memoryId]: diags },
-    })),
-
-  clearMemoryDiagnostics: (memoryId) =>
-    set((state) => {
-      const { [memoryId]: _, ...rest } = state.byMemoryId;
-      return { byMemoryId: rest };
-    }),
-
-  setModelDiagnostics: (modelId, diags) =>
-    set((state) => ({
-      byModelId: { ...state.byModelId, [modelId]: diags },
-    })),
-
-  clearModelDiagnostics: (modelId) =>
-    set((state) => {
-      const { [modelId]: _, ...rest } = state.byModelId;
-      return { byModelId: rest };
-    }),
-
-  setFunctionDiagnostics: (functionId, diags) =>
-    set((state) => ({
-      byFunctionId: { ...state.byFunctionId, [functionId]: diags },
-    })),
-
-  clearFunctionDiagnostics: (functionId) =>
-    set((state) => {
-      const { [functionId]: _, ...rest } = state.byFunctionId;
-      return { byFunctionId: rest };
-    }),
-}));
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 ForestHub. All rights reserved.
+// For commercial licensing, contact root@foresthub.ai
+
+/**
+ * diagnosticsStore.ts
+ *
+ * This Zustand store manages diagnostics (errors and warnings) for the currently active canvas
+ * in the workflow builder. It holds diagnostics for nodes and edges, keyed by their IDs.
+ *
+ * Key design points:
+ * - Only diagnostics for the active canvas are stored (flat, not per-canvas).
+ * - Diagnostics are written by node/edge components via useEffect, and cleared on unmount.
+ * - On canvas switch, the store is cleared and repopulated for the new canvas.
+ * - Used for real-time UI feedback (badges, warnings) in the workflow builder.
+ * - For full-project validation (e.g., before code generation), use validateAllCanvases() in utils/diagnostics.ts.
+ *
+ * See docs/diagnostics.md for full architecture and lifecycle details.
+ */
+import { create } from "zustand";
+import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
+
+interface DiagnosticsState {
+  byNodeId: Record<string, Diagnostic[]>;
+  byEdgeId: Record<string, Diagnostic[]>;
+  /**
+   * Channels are project-scoped, not canvas-scoped, so this slot lives
+   * here regardless of the active canvas. Written by ChannelDiagnosticsSync,
+   * which is mounted once at the workflow builder root.
+   */
+  byChannelId: Record<string, Diagnostic[]>;
+  /**
+   * Memory primitives are project-scoped like channels. Written by
+   * MemoryDiagnosticsSync, mounted once at the workflow builder root.
+   */
+  byMemoryId: Record<string, Diagnostic[]>;
+  /**
+   * Declared models are project-scoped like channels/memory. Written by
+   * ModelDiagnosticsSync, mounted once at the workflow builder root.
+   */
+  byModelId: Record<string, Diagnostic[]>;
+  /**
+   * Functions are project-scoped declarations. Keyed by function id. Written by
+   * the resource diagnostics sync, mounted once at the workflow builder root.
+   */
+  byFunctionId: Record<string, Diagnostic[]>;
+  setNodeDiagnostics: (nodeId: string, diags: Diagnostic[]) => void;
+  clearNodeDiagnostics: (nodeId: string) => void;
+  setEdgeDiagnostics: (edgeId: string, diags: Diagnostic[]) => void;
+  clearEdgeDiagnostics: (edgeId: string) => void;
+  setChannelDiagnostics: (channelId: string, diags: Diagnostic[]) => void;
+  clearChannelDiagnostics: (channelId: string) => void;
+  setMemoryDiagnostics: (memoryId: string, diags: Diagnostic[]) => void;
+  clearMemoryDiagnostics: (memoryId: string) => void;
+  setModelDiagnostics: (modelId: string, diags: Diagnostic[]) => void;
+  clearModelDiagnostics: (modelId: string) => void;
+  setFunctionDiagnostics: (functionId: string, diags: Diagnostic[]) => void;
+  clearFunctionDiagnostics: (functionId: string) => void;
+}
+
+export const useDiagnosticsStore = create<DiagnosticsState>((set) => ({
+  byNodeId: {},
+  byEdgeId: {},
+  byChannelId: {},
+  byMemoryId: {},
+  byModelId: {},
+  byFunctionId: {},
+
+  setNodeDiagnostics: (nodeId, diags) =>
+    set((state) => ({
+      byNodeId: { ...state.byNodeId, [nodeId]: diags },
+    })),
+
+  clearNodeDiagnostics: (nodeId) =>
+    set((state) => {
+      const { [nodeId]: _, ...rest } = state.byNodeId;
+      return { byNodeId: rest };
+    }),
+
+  setEdgeDiagnostics: (edgeId, diags) =>
+    set((state) => ({
+      byEdgeId: { ...state.byEdgeId, [edgeId]: diags },
+    })),
+
+  clearEdgeDiagnostics: (edgeId) =>
+    set((state) => {
+      const { [edgeId]: _, ...rest } = state.byEdgeId;
+      return { byEdgeId: rest };
+    }),
+
+  setChannelDiagnostics: (channelId, diags) =>
+    set((state) => ({
+      byChannelId: { ...state.byChannelId, [channelId]: diags },
+    })),
+
+  clearChannelDiagnostics: (channelId) =>
+    set((state) => {
+      const { [channelId]: _, ...rest } = state.byChannelId;
+      return { byChannelId: rest };
+    }),
+
+  setMemoryDiagnostics: (memoryId, diags) =>
+    set((state) => ({
+      byMemoryId: { ...state.byMemoryId, [memoryId]: diags },
+    })),
+
+  clearMemoryDiagnostics: (memoryId) =>
+    set((state) => {
+      const { [memoryId]: _, ...rest } = state.byMemoryId;
+      return { byMemoryId: rest };
+    }),
+
+  setModelDiagnostics: (modelId, diags) =>
+    set((state) => ({
+      byModelId: { ...state.byModelId, [modelId]: diags },
+    })),
+
+  clearModelDiagnostics: (modelId) =>
+    set((state) => {
+      const { [modelId]: _, ...rest } = state.byModelId;
+      return { byModelId: rest };
+    }),
+
+  setFunctionDiagnostics: (functionId, diags) =>
+    set((state) => ({
+      byFunctionId: { ...state.byFunctionId, [functionId]: diags },
+    })),
+
+  clearFunctionDiagnostics: (functionId) =>
+    set((state) => {
+      const { [functionId]: _, ...rest } = state.byFunctionId;
+      return { byFunctionId: rest };
+    }),
+}));