instant-ctrl-flow-logic 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instant-ctrl-flow-logic",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "description": "InstantCtrlFlow 引擎：xnl bundle 加载 → 行为树编译 → 无状态单次执行",
   "type": "module",
@@ -11,15 +11,14 @@
     "./filesystem": "./src/filesystem.ts"
   },
   "dependencies": {
-    "xnl-core": "^0.1.8",
     "depa-behavior-tree": "0.1.0",
-    "instant-ctrl-flow-contract": "0.1.0"
+    "instant-ctrl-flow-contract": "0.1.0",
+    "xnl-core": "^0.1.8"
   },
   "files": [
     "src"
   ],
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.com"
+    "access": "public"
   }
-}
+}

package/src/handlers.ts

@@ -93,6 +93,7 @@ export interface FlowDecisionContext {
 export interface FlowDecisionHooks {
   begin(ifPath: string): FlowDecisionContext;
   record(decision: FlowBranchDecision): Promise<void> | void;
+  runtimeForNode?(nodeId: string, runtime: InstantCtrlFlowRuntime): InstantCtrlFlowRuntime;
 }
 
 class FlowFunctionLoader {
@@ -100,8 +101,13 @@ class FlowFunctionLoader {
   constructor(
     private spec: FlowBundleSpec,
     private resolveCode: FlowCodeResolver,
+    private runtimeHooks?: FlowDecisionHooks,
   ) {}
 
+  runtimeForNode(nodeId: string, runtime: InstantCtrlFlowRuntime): InstantCtrlFlowRuntime {
+    return this.runtimeHooks?.runtimeForNode?.(nodeId, runtime) ?? runtime;
+  }
+
   load(src: string, nodeId: string): Promise<FlowCodeFunction> {
     let loaded = this.cache.get(src);
     if (!loaded) {
@@ -128,7 +134,8 @@ function configOf(ctx: Ctx): NodeConfig {
 async function callCode(ctx: Ctx, loader: FlowFunctionLoader, src: string): Promise<unknown> {
   const state = flowStateOf(ctx);
   const fn = await loader.load(src, ctx.node.Key);
-  return fn((ctx.runtime ?? {}) as InstantCtrlFlowRuntime, state.current, configOf(ctx).config ?? {});
+  const runtime = (ctx.runtime ?? {}) as InstantCtrlFlowRuntime;
+  return fn(loader.runtimeForNode(ctx.node.Key, runtime), state.current, configOf(ctx).config ?? {});
 }
 
 function fail(state: FlowExecutionState, error: unknown): BehaviorResult {
@@ -277,7 +284,7 @@ class StrategyStartHandler implements ActionHandler<CtrlFlowNodeType, INodeConfi
     if (state.returned) return BehaviorResult.Success;
     const key = String(configOf(ctx).fallbackKey);
     state.current = state.fallbackInputs[key];
-    state.fault = undefined;
+    delete state.fault;
     return BehaviorResult.Success;
   }
 }
@@ -288,7 +295,7 @@ class FallbackStartHandler implements ActionHandler<CtrlFlowNodeType, INodeConfi
     if (state.returned) return BehaviorResult.Success;
     const key = String(configOf(ctx).fallbackKey);
     state.fallbackInputs[key] = state.current;
-    state.fault = undefined;
+    delete state.fault;
     return BehaviorResult.Success;
   }
 }
@@ -440,7 +447,7 @@ export function createFlowHandlers(
   executeBody?: FlowBodyExecutor,
   executeTarget?: FlowTargetExecutor,
 ): Record<string, ActionHandler<CtrlFlowNodeType, INodeConfig>> {
-  const loader = new FlowFunctionLoader(spec, resolveCode);
+  const loader = new FlowFunctionLoader(spec, resolveCode, decisionHooks);
   const activeDecisions = new Map<string, FlowDecisionContext>();
   return {
     'flow.Run': new RunHandler(loader),

package/src/loader.ts

@@ -107,9 +107,37 @@ export interface LoadResult {
   diagnostics: FlowDiagnostic[];
 }
 
+export interface LoadCtrlFlowProfileSourcesOptions extends LoadFlowSourcesOptions {
+  profileRoot: string;
+  substrateForm: FlowForm;
+}
+
 export function loadFlowBundleFromSources(
   sources: FlowSourceCollection,
   options: LoadFlowSourcesOptions = {},
+): LoadResult {
+  return loadCtrlFlowSources(sources, options);
+}
+
+export function loadCtrlFlowProfileFromSources(
+  sources: FlowSourceCollection,
+  options: LoadCtrlFlowProfileSourcesOptions,
+): LoadResult {
+  if (!options.profileRoot.trim()) {
+    return {
+      diagnostics: [{ code: 'invalid-profile-root', message: 'profile root must be a non-empty XNL tag' }],
+    };
+  }
+  return loadCtrlFlowSources(sources, options, {
+    rootTag: options.profileRoot,
+    substrateForm: options.substrateForm,
+  });
+}
+
+function loadCtrlFlowSources(
+  sources: FlowSourceCollection,
+  options: LoadFlowSourcesOptions,
+  profile?: { rootTag: string; substrateForm: FlowForm },
 ): LoadResult {
   const diagnostics: FlowDiagnostic[] = [];
   const note = (code: string, message: string) => diagnostics.push({ code, message });
@@ -168,14 +196,25 @@ export function loadFlowBundleFromSources(
 
   for (const tag of Object.keys(fileRoots)) noteLegacyTag(tag);
 
-  const form = FORMS.find((candidate) => fileRoots[candidate]);
+  const form = profile?.substrateForm ?? FORMS.find((candidate) => fileRoots[candidate]);
   if (!form) {
     if (noted.size) return { diagnostics };
     note('no-container', `no container root found in ${options.baseUri ?? 'named source collection'}`);
     return { diagnostics };
   }
-  const container = fileRoots[form].el;
-  const containerFile = fileRoots[form].file;
+  const rootTag = profile?.rootTag ?? form;
+  const rootEntry = fileRoots[rootTag];
+  if (!rootEntry) {
+    note(
+      profile ? 'profile-root-missing' : 'no-container',
+      profile
+        ? `expected profile root <${rootTag}> in ${options.baseUri ?? 'named source collection'}`
+        : `no container root found in ${options.baseUri ?? 'named source collection'}`,
+    );
+    return { diagnostics };
+  }
+  const container = rootEntry.el;
+  const containerFile = rootEntry.file;
 
   // Facet discovery is physical; toNodeSpec remains a pure XNL-to-contract projection.
   const facets: Partial<Record<FacetName, XnlEl>> = {};