add GraphDiagnostic flow metadata types (#103)

Add FlowDiagnosticMeta type and optional flow field to GraphDiagnostic
for future flow-scoped diagnostics. No runtime behavior changes.

Author: mahyarmlk

.changeset/five-ducks-sleep.md

@@ -0,0 +1,5 @@
+---
+"@intent-framework/core": minor
+---
+
+Add public `FlowDiagnosticMeta` type and optional `flow` metadata to `GraphDiagnostic` for future flow-scoped diagnostics.

packages/core/src/graph.ts

@@ -4,12 +4,18 @@ import type { AnyResourceNode } from "./resource.js"
 
 export type DiagnosticSeverity = "info" | "warning" | "error"
 
+export type FlowDiagnosticMeta = {
+  flowNodeId: string
+  flowSemanticNodeId?: string
+}
+
 export type GraphDiagnostic = {
   severity: DiagnosticSeverity
   code: string
   message: string
   nodeId?: string
   semanticNodeId?: string
+  flow?: FlowDiagnosticMeta
 }
 
 export type InspectedScreen = {

packages/core/src/index.ts

@@ -1,7 +1,7 @@
 export { screen } from "./screen.js"
 export type { ScreenDefinition, ScreenBuilder } from "./screen.js"
 export { inspectScreen } from "./graph.js"
-export type { InspectedScreen, GraphDiagnostic, DiagnosticSeverity } from "./graph.js"
+export type { InspectedScreen, GraphDiagnostic, DiagnosticSeverity, FlowDiagnosticMeta } from "./graph.js"
 export type { TextState, BooleanState, ChoiceState } from "./state.js"
 export type { AskNode, AnyAskNode, AskKind, AskBuilder } from "./ask.js"
 export type { ActNode, ActCondition, ActStatus, FeedbackConfig, ActBuilder, NavigationService, ActionExecutionContext, DefaultScreenServices } from "./act.js"