chore(eslint): enforce consistent-type-imports and apply the repo-wide autofix

eslint.config.js

@@ -49,6 +49,19 @@ export default defineConfig(
       "@typescript-eslint/no-unused-vars": "off",
       "@typescript-eslint/no-explicit-any": "off",
       "react/react-in-jsx-scope": "off",
+      // `disallowTypeAnnotations` must stay off: inline `import()` types are how
+      // optional peer dependencies are typed here (e.g. `typeof import("pg")`)
+      // without forcing a static import that would break consumers who have not
+      // installed the package. Turning it on flags those deliberate annotations,
+      // and they are not autofixable.
+      "@typescript-eslint/consistent-type-imports": [
+        "error",
+        {
+          prefer: "type-imports",
+          fixStyle: "separate-type-imports",
+          disallowTypeAnnotations: false,
+        },
+      ],
     },
   },
   {

examples/cli/src/run-interactive.ts

@@ -4,8 +4,14 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type { ITask, IWorkflow, TaskGraphRunConfig, WorkflowRunConfig } from "@workglow/task-graph";
-import { IRunConfig, TaskGraph } from "@workglow/task-graph";
+import type {
+  IRunConfig,
+  ITask,
+  IWorkflow,
+  TaskGraphRunConfig,
+  WorkflowRunConfig,
+} from "@workglow/task-graph";
+import { TaskGraph } from "@workglow/task-graph";
 import { detectCliTheme, setCliTheme } from "./terminal/detectTerminalTheme";
 import { renderTaskInstanceRun, renderWorkflowRun } from "./ui/render";
 

examples/cli/src/test/samples.test.ts

@@ -6,11 +6,11 @@
 
 import { registerAiTasks } from "@workglow/ai";
 import { InMemoryTabularStorage } from "@workglow/storage";
+import type { Task } from "@workglow/task-graph";
 import {
   computeGraphInputSchema,
   createGraphFromGraphJSON,
   registerBaseTasks,
-  Task,
   TaskGraph,
   TaskGraphPrimaryKeyNames,
   TaskGraphSchema,

examples/cli/src/ui/render.ts

@@ -5,7 +5,7 @@
  */
 
 import type { IRunConfig, ITask, ITaskConstructor, TaskGraph } from "@workglow/task-graph";
-import { InputTaskConfig } from "@workglow/tasks";
+import type { InputTaskConfig } from "@workglow/tasks";
 import { render } from "ink";
 import React from "react";
 import type { PromptFieldDescriptor } from "../input/prompt";

examples/web/src/App.tsx

@@ -6,11 +6,11 @@
 
 import { registerAiTasks } from "@workglow/ai";
 import { registerHuggingFaceTransformers } from "@workglow/huggingface-transformers/ai";
+import type { JsonTaskItem } from "@workglow/task-graph";
 import {
   CACHE_REGISTRY,
   DefaultCacheRegistry,
   getTaskQueueRegistry,
-  JsonTaskItem,
   registerBaseTasks,
   TaskGraph,
   Workflow,

examples/web/src/components/TaskDataButtons.tsx

@@ -1,4 +1,5 @@
-import { ITask, TaskStatus } from "@workglow/task-graph";
+import type { ITask } from "@workglow/task-graph";
+import { TaskStatus } from "@workglow/task-graph";
 import { ViewportPortal } from "@xyflow/react";
 import React, { useState } from "react";
 import { DataDialog } from "./DataDialog";

examples/web/src/dependencyJson.ts

@@ -4,7 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { createGraphFromDependencyJSON, JsonTaskItem, TaskGraph } from "@workglow/task-graph";
+import type { JsonTaskItem, TaskGraph } from "@workglow/task-graph";
+import { createGraphFromDependencyJSON } from "@workglow/task-graph";
 
 /** True if any task item (including nested subtasks) is a synthetic boundary task. */
 export function dependencyJsonHasBoundaryTasks(items: JsonTaskItem[]): boolean {

examples/web/src/graph/DataflowEdge.tsx

@@ -4,8 +4,10 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { Dataflow, TaskStatus } from "@workglow/task-graph";
-import { BaseEdge, Edge, EdgeLabelRenderer, EdgeProps, getBezierPath } from "@xyflow/react";
+import type { Dataflow } from "@workglow/task-graph";
+import { TaskStatus } from "@workglow/task-graph";
+import type { Edge, EdgeProps } from "@xyflow/react";
+import { BaseEdge, EdgeLabelRenderer, getBezierPath } from "@xyflow/react";
 import { useEffect, useMemo, useState } from "react";
 import { DataDialog } from "../components/DataDialog";
 import { getStatusColorBg } from "./util";

examples/web/src/graph/NodeContainer.tsx

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { TaskStatus } from "@workglow/task-graph";
+import type { TaskStatus } from "@workglow/task-graph";
 import { Handle, Position } from "@xyflow/react";
 import React from "react";
 

examples/web/src/graph/NodeHeader.tsx

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { TaskStatus } from "@workglow/task-graph";
+import type { TaskStatus } from "@workglow/task-graph";
 import React from "react";
 import { getStatusColorBg } from "./util";
 

examples/web/src/graph/NodeTaskProps.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { ITask, TaskStatus } from "@workglow/task-graph";
+import type { ITask, TaskStatus } from "@workglow/task-graph";
 
 // Common props for all node types
 export interface NodeTaskProps {

examples/web/src/graph/RunGraphFlow.tsx

@@ -4,22 +4,16 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { Dataflow, TaskGraph, TaskGraphEvents } from "@workglow/task-graph";
-import {
-  Controls,
-  Edge,
-  EdgeTypes,
-  Node,
-  NodeTypes,
-  ReactFlow,
-  useEdgesState,
-  useNodesState,
-  useReactFlow,
-} from "@xyflow/react";
-import React, { Dispatch, SetStateAction, useCallback, useEffect, useRef } from "react";
+import type { Dataflow, TaskGraph, TaskGraphEvents } from "@workglow/task-graph";
+import type { Edge, EdgeTypes, Node, NodeTypes } from "@xyflow/react";
+import { Controls, ReactFlow, useEdgesState, useNodesState, useReactFlow } from "@xyflow/react";
+import type { Dispatch, SetStateAction } from "react";
+import React, { useCallback, useEffect, useRef } from "react";
 import { computeLayout, GraphPipelineCenteredLayout, GraphPipelineLayout } from "../layout";
-import { DataflowEdge, DataflowEdgeData } from "./DataflowEdge";
-import { TaskNode, TaskNodeData } from "./TaskNode";
+import type { DataflowEdgeData } from "./DataflowEdge";
+import { DataflowEdge } from "./DataflowEdge";
+import type { TaskNodeData } from "./TaskNode";
+import { TaskNode } from "./TaskNode";
 import { updateNode } from "./util";
 
 import "@xyflow/react/dist/base.css";

examples/web/src/graph/TaskNode.tsx

@@ -4,9 +4,10 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { ITask, TaskStatus, type StreamEvent } from "@workglow/task-graph";
+import type { ITask, StreamEvent } from "@workglow/task-graph";
+import { TaskStatus } from "@workglow/task-graph";
 import { ArrayTask } from "@workglow/tasks";
-import { Node, NodeProps } from "@xyflow/react";
+import type { Node, NodeProps } from "@xyflow/react";
 import { useEffect, useRef, useState } from "react";
 import { FiCloud, FiCloudLightning } from "react-icons/fi";
 import { ProgressBar } from "../components/ProgressBar";

examples/web/src/graph/util.ts

@@ -4,7 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { ITask, TaskStatus } from "@workglow/task-graph";
+import type { ITask } from "@workglow/task-graph";
+import { TaskStatus } from "@workglow/task-graph";
 
 export const getStatusColorBg = (status: TaskStatus): string => {
   switch (status) {

examples/web/src/layout.ts

@@ -5,7 +5,7 @@
  */
 
 import { DirectedAcyclicGraph } from "@workglow/util/graph";
-import { Edge, Node } from "@xyflow/react";
+import type { Edge, Node } from "@xyflow/react";
 
 type PositionXY = {
   x: number;

examples/web/src/status/GraphStoreStatus.tsx

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { TaskGraphRepository } from "@workglow/task-graph";
+import type { TaskGraphRepository } from "@workglow/task-graph";
 import { useCallback } from "react";
 
 export function GraphStoreStatus({ repository }: { repository: TaskGraphRepository }) {

examples/web/src/status/OutputRepositoryStatus.tsx

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { TaskOutputRepository } from "@workglow/task-graph";
+import type { TaskOutputRepository } from "@workglow/task-graph";
 import { useCallback, useEffect, useState } from "react";
 
 export function OutputRepositoryStatus({

packages/ai/src/job/AiJob.ts

@@ -4,15 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import type { IJobExecuteContext } from "@workglow/job-queue";
 import {
   AbortSignalJobError,
-  IJobExecuteContext,
   Job,
   PermanentJobError,
   RetryableJobError,
   withJobErrorDiagnostics,
 } from "@workglow/job-queue";
-import { TaskInput, TaskOutput } from "@workglow/task-graph";
+import type { TaskInput, TaskOutput } from "@workglow/task-graph";
 import type { JsonSchema } from "@workglow/util/schema";
 import type { AiEmit } from "../capability/AiEmit";
 import type { Capability } from "../capability/Capabilities";

packages/ai/src/model/ModelRegistry.ts

@@ -4,15 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import type { ServiceRegistry } from "@workglow/util";
 import {
   createServiceToken,
   globalServiceRegistry,
   registerInputCompactor,
   registerInputResolver,
-  ServiceRegistry,
 } from "@workglow/util";
 import { InMemoryModelRepository } from "./InMemoryModelRepository";
-import { ModelRepository } from "./ModelRepository";
+import type { ModelRepository } from "./ModelRepository";
 import type { ModelConfig } from "./ModelSchema";
 
 export const MODEL_REPOSITORY = createServiceToken<ModelRepository>("model.repository");

packages/ai/src/model/ModelRepository.ts

@@ -4,12 +4,14 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { ITabularStorage } from "@workglow/storage";
-import { EventEmitter, EventParameters } from "@workglow/util";
+import type { ITabularStorage } from "@workglow/storage";
+import type { EventParameters } from "@workglow/util";
+import { EventEmitter } from "@workglow/util";
 import type { DataPortSchemaObject, SchemaNode } from "@workglow/util/schema";
 import { compileSchema } from "@workglow/util/schema";
 
-import { ModelPrimaryKeyNames, ModelRecord, ModelRecordSchema } from "./ModelSchema";
+import type { ModelPrimaryKeyNames, ModelRecord } from "./ModelSchema";
+import { ModelRecordSchema } from "./ModelSchema";
 
 export type ModelEventListeners = {
   model_added: (model: ModelRecord) => void;

packages/ai/src/model/ModelSchema.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { DataPortSchemaObject } from "@workglow/util/worker";
+import type { DataPortSchemaObject } from "@workglow/util/worker";
 
 /**
  * A model configuration suitable for task/job inputs.

packages/ai/src/provider/AiProviderRegistry.ts

@@ -4,8 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type { StreamEvent } from "@workglow/task-graph";
-import { TaskInput, TaskOutput } from "@workglow/task-graph";
+import type { StreamEvent, TaskInput, TaskOutput } from "@workglow/task-graph";
 import type { JsonSchema, ServiceRegistry } from "@workglow/util/worker";
 import { createServiceToken, globalServiceRegistry, WORKER_MANAGER } from "@workglow/util/worker";
 import type { AiEmit } from "../capability/AiEmit";

packages/ai/src/task/ChunkRetrievalTask.ts

@@ -4,11 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type { ChunkRecord, ChunkSearchResult } from "@workglow/knowledge-base";
-import { KnowledgeBase, TypeKnowledgeBase } from "@workglow/knowledge-base";
-import type { IRunConfig, TaskConfig } from "@workglow/task-graph";
-import { CreateWorkflow, IExecuteContext, Task, Workflow } from "@workglow/task-graph";
-import { DataPortSchema, isTypedArray, TypedArray, TypedArraySchema } from "@workglow/util/schema";
+import type { ChunkRecord, ChunkSearchResult, KnowledgeBase } from "@workglow/knowledge-base";
+import { TypeKnowledgeBase } from "@workglow/knowledge-base";
+import type { IExecuteContext, IRunConfig, TaskConfig } from "@workglow/task-graph";
+import { CreateWorkflow, Task, Workflow } from "@workglow/task-graph";
+import type { DataPortSchema, TypedArray } from "@workglow/util/schema";
+import { isTypedArray, TypedArraySchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
 import type { ModelConfig } from "../model/ModelSchema";
 import { TypeModel } from "./base/AiTaskSchemas";

packages/ai/src/task/ChunkVectorUpsertTask.ts

@@ -6,9 +6,10 @@
 
 import type { ChunkRecord, KnowledgeBase } from "@workglow/knowledge-base";
 import { ChunkRecordArraySchema, TypeKnowledgeBase } from "@workglow/knowledge-base";
-import type { CachePolicy, IRunConfig, TaskConfig } from "@workglow/task-graph";
-import { CreateWorkflow, IExecuteContext, Task, Workflow } from "@workglow/task-graph";
-import { DataPortSchema, TypedArray, TypedArraySchema } from "@workglow/util/schema";
+import type { CachePolicy, IExecuteContext, IRunConfig, TaskConfig } from "@workglow/task-graph";
+import { CreateWorkflow, Task, Workflow } from "@workglow/task-graph";
+import type { DataPortSchema, TypedArray } from "@workglow/util/schema";
+import { TypedArraySchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
 import { TypeSingleOrArray } from "./base/AiTaskSchemas";
 

packages/ai/src/task/ContextBuilderTask.ts

@@ -5,15 +5,14 @@
  */
 
 import { estimateTokens } from "@workglow/knowledge-base";
-import type { IRunConfig, TaskConfig } from "@workglow/task-graph";
-import {
-  CreateWorkflow,
+import type {
   IExecuteContext,
   IExecutePreviewContext,
-  Task,
-  Workflow,
+  IRunConfig,
+  TaskConfig,
 } from "@workglow/task-graph";
-import { DataPortSchema } from "@workglow/util/schema";
+import { CreateWorkflow, Task, Workflow } from "@workglow/task-graph";
+import type { DataPortSchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
 import type { ModelConfig } from "../model/ModelSchema";
 import { CountTokensTask } from "./CountTokensTask";

packages/ai/src/task/CountTokensTask.ts

@@ -6,7 +6,7 @@
 
 import type { IRunConfig, TaskConfig } from "@workglow/task-graph";
 import { CreateWorkflow, Workflow } from "@workglow/task-graph";
-import { DataPortSchema } from "@workglow/util/schema";
+import type { DataPortSchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
 import type { ModelConfig } from "../model/ModelSchema";
 import { AiTask } from "./base/AiTask";

packages/ai/src/task/DocumentEnricherTask.ts

@@ -4,14 +4,19 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { DocumentRootNode, getChildren, hasChildren } from "@workglow/knowledge-base";
-
-import type { DocumentNode, Entity, NodeEnrichment } from "@workglow/knowledge-base";
-import type { IRunConfig, TaskConfig } from "@workglow/task-graph";
-import { CreateWorkflow, IExecuteContext, Task, Workflow } from "@workglow/task-graph";
-import { DataPortSchema } from "@workglow/util/schema";
+import { getChildren, hasChildren } from "@workglow/knowledge-base";
+
+import type {
+  DocumentNode,
+  DocumentRootNode,
+  Entity,
+  NodeEnrichment,
+} from "@workglow/knowledge-base";
+import type { IExecuteContext, IRunConfig, TaskConfig } from "@workglow/task-graph";
+import { CreateWorkflow, Task, Workflow } from "@workglow/task-graph";
+import type { DataPortSchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
-import { ModelConfig } from "../model/ModelSchema";
+import type { ModelConfig } from "../model/ModelSchema";
 import { TextNamedEntityRecognitionTask } from "./TextNamedEntityRecognitionTask";
 import { TextSummaryTask } from "./TextSummaryTask";
 import { TypeModel } from "./base/AiTaskSchemas";

packages/ai/src/task/DocumentUpsertTask.ts

@@ -4,16 +4,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import type { DocumentMetadata, DocumentNode } from "@workglow/knowledge-base";
-import {
-  Document,
-  DocumentMetadataSchema,
-  KnowledgeBase,
-  TypeKnowledgeBase,
-} from "@workglow/knowledge-base";
-import type { CachePolicy, IRunConfig, TaskConfig } from "@workglow/task-graph";
-import { CreateWorkflow, IExecuteContext, Task, Workflow } from "@workglow/task-graph";
-import { DataPortSchema } from "@workglow/util/schema";
+import type { DocumentMetadata, DocumentNode, KnowledgeBase } from "@workglow/knowledge-base";
+import { Document, DocumentMetadataSchema, TypeKnowledgeBase } from "@workglow/knowledge-base";
+import type { CachePolicy, IExecuteContext, IRunConfig, TaskConfig } from "@workglow/task-graph";
+import { CreateWorkflow, Task, Workflow } from "@workglow/task-graph";
+import type { DataPortSchema } from "@workglow/util/schema";
 import type { Capability } from "../capability/Capabilities";
 
 const inputSchema = {