@intent-framework/core 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/graph.d.ts

@@ -2,12 +2,17 @@ import type { ScreenDefinition } from "./screen.js";
 import type { DefaultScreenServices } from "./act.js";
 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 = {
     name: string;

package/dist/index.d.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";

package/dist/index.js

@@ -764,6 +764,22 @@ function computeDiagnostics(screenDef) {
 	if (screenDef.flows.length > 0) {
 		const flowNodeIds = /* @__PURE__ */ new Set();
 		for (const flow of screenDef.flows) for (const step of flow.steps) flowNodeIds.add(step.node.id);
+		for (const flow of screenDef.flows) for (const step of flow.steps) if (!surfacedNodeIds.has(step.node.id)) diagnostics.push({
+			severity: "warning",
+			code: "flow-step-not-surfaced",
+			message: `"${step.node.label}" is a flow step but not included in any surface.`,
+			nodeId: step.node.id,
+			flow: { flowNodeId: flow.id }
+		});
+		for (const flow of screenDef.flows) if (flow.steps.length > 0) {
+			const hasSurfacedStep = flow.steps.some((step) => surfacedNodeIds.has(step.node.id));
+			if (!hasSurfacedStep) diagnostics.push({
+				severity: "warning",
+				code: "orphaned-flow",
+				message: `"${flow.name}" has no surfaced steps.`,
+				flow: { flowNodeId: flow.id }
+			});
+		}
 		for (const ask of screenDef.asks) if (surfacedNodeIds.has(ask.id) && !flowNodeIds.has(ask.id)) diagnostics.push({
 			severity: "info",
 			code: "surfaced-node-not-in-any-flow",
@@ -789,9 +805,15 @@ function inspectScreen(screenDef, runtimeResources) {
 	const idToSemantic = /* @__PURE__ */ new Map();
 	for (const a of screenDef.asks) idToSemantic.set(a.id, askIds(a.label));
 	for (const a of screenDef.acts) idToSemantic.set(a.id, actIds(a.label));
+	const idToFlowSemantic = /* @__PURE__ */ new Map();
+	for (const f of screenDef.flows) idToFlowSemantic.set(f.id, flowIds(f.name));
 	const augmentedDiagnostics = diagnostics.map((d) => ({
 		...d,
-		semanticNodeId: d.nodeId ? idToSemantic.get(d.nodeId) : void 0
+		semanticNodeId: d.nodeId ? idToSemantic.get(d.nodeId) : void 0,
+		flow: d.flow ? {
+			...d.flow,
+			flowSemanticNodeId: idToFlowSemantic.get(d.flow.flowNodeId)
+		} : void 0
 	}));
 	return {
 		name: screenDef.name,
@@ -819,7 +841,7 @@ function inspectScreen(screenDef, runtimeResources) {
 		})),
 		flows: screenDef.flows.map((f) => ({
 			id: f.id,
-			semanticId: flowIds(f.name),
+			semanticId: idToFlowSemantic.get(f.id),
 			name: f.name,
 			stepCount: f.steps.length
 		})),

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "Platformless semantic graph and runtime for Intent applications",
   "license": "MIT",
   "repository": {