instant-ctrl-flow-logic 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instant-ctrl-flow-logic",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "description": "InstantCtrlFlow 引擎：xnl bundle 加载 → 行为树编译 → 无状态单次执行",
   "type": "module",
@@ -12,7 +12,9 @@
   },
   "dependencies": {
     "depa-behavior-tree": "0.1.0",
-    "instant-ctrl-flow-contract": "0.1.0",
+    "flow-step-space-contract": "0.1.1",
+    "flow-step-space-logic": "0.1.1",
+    "instant-ctrl-flow-contract": "0.1.2",
     "xnl-core": "^0.1.8"
   },
   "files": [

package/src/filesystem.ts

@@ -3,12 +3,17 @@ import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 import type { FlowCodeFunction, FlowCodeResolver, LoadFlowSourcesOptions } from 'instant-ctrl-flow-contract';
 import { loadFlowBundleFromSources, type LoadResult } from './loader.js';
+import {
+  assembleDefinitionStepProfileDirectory,
+  createFilesystemDefinitionStepProfileRuntime,
+} from 'flow-step-space-logic/filesystem';
 import { FlowLoadError, runInstantCtrlFlowSpec } from './engine.js';
 import type { InstantCtrlFlowRunOptions } from 'instant-ctrl-flow-contract';
 
 /** Filesystem convenience only; parsing and validation belong to the named-source loader. */
 export function loadFlowBundle(dir: string, options: LoadFlowSourcesOptions = {}): LoadResult {
   const absoluteDir = path.resolve(dir);
+  const stepRuntime = createFilesystemDefinitionStepProfileRuntime({ rootDir: absoluteDir });
   const sources = fs.existsSync(absoluteDir)
     ? fs.readdirSync(absoluteDir, { withFileTypes: true })
         .filter((entry) => entry.isFile() && entry.name.endsWith('.xnl'))
@@ -18,6 +23,26 @@ export function loadFlowBundle(dir: string, options: LoadFlowSourcesOptions = {}
           content: fs.readFileSync(path.join(absoluteDir, entry.name), 'utf8'),
         }))
     : [];
+  for (const profileRoot of ['InstantCtrlFlow', 'WorkCtrlFlow', 'BPCtrlFlow']) {
+    const assembled = assembleDefinitionStepProfileDirectory(
+      stepRuntime,
+      {},
+      { ...(options.stepSpace ?? {}), profileRoot },
+    );
+    if (assembled.diagnostics.length > 0) {
+      return { diagnostics: assembled.diagnostics.map(({ code, message }) => ({ code, message })) };
+    }
+    if (!assembled.forest) continue;
+    const projectedSources = (assembled.sources as readonly ({ readonly ref: string; readonly content: string } | { readonly name: string; readonly content: string })[])
+      .map((source) => ({ name: 'name' in source ? source.name : source.ref, content: source.content }));
+    const loaded = loadFlowBundleFromSources(projectedSources, {
+      ...options,
+      baseUri: options.baseUri ?? absoluteDir,
+    });
+    return loaded.spec
+      ? { ...loaded, spec: { ...loaded.spec, definitionStepForest: assembled.forest } }
+      : loaded;
+  }
   return loadFlowBundleFromSources(sources, { ...options, baseUri: options.baseUri ?? absoluteDir });
 }
 

package/src/loader.ts

@@ -4,6 +4,11 @@
  * 完整 lint 由 tools/flow-dsl-check 承担；此处只做引擎必需的结构化与硬校验。
  */
 import { parseXnl } from 'xnl-core';
+import {
+  assembleDefinitionStepProfile,
+  createDefinitionStepSourceRuntime,
+} from 'flow-step-space-logic';
+import type { DefinitionStepForest, DefinitionStepSourceCollection } from 'flow-step-space-contract';
 import type {
   FlowBundleSpec,
   CtrlFlowContract,
@@ -167,9 +172,34 @@ function loadCtrlFlowSources(
     }
   };
 
-  const sourceEntries = (Array.isArray(sources)
-    ? sources.map(({ name, content }) => ({ name, content }))
-    : Object.entries(sources).map(([name, content]) => ({ name, content })))
+  let definitionStepForest: DefinitionStepForest | undefined;
+  let effectiveSources = sources;
+  const definitionSources: DefinitionStepSourceCollection = Array.isArray(sources)
+    ? sources.map((source) => ({ ref: source.name, content: source.content }))
+    : Object.entries(sources).map(([ref, content]) => ({ ref, content }));
+  const stepRuntime = createDefinitionStepSourceRuntime(definitionSources);
+  for (const candidateRoot of profile ? [profile.rootTag] : FORMS) {
+    const assembled = assembleDefinitionStepProfile(
+      stepRuntime,
+      { sources: definitionSources },
+      { ...(options.stepSpace ?? {}), profileRoot: candidateRoot },
+    );
+    if (assembled.diagnostics.length > 0) {
+      return { diagnostics: assembled.diagnostics.map(({ code, message }) => ({ code, message })) };
+    }
+    if (assembled.forest) {
+      effectiveSources = assembled.sources as FlowSourceCollection;
+      definitionStepForest = assembled.forest;
+      break;
+    }
+  }
+
+  const sourceEntries = (Array.isArray(effectiveSources)
+    ? effectiveSources.map((source) => ({
+        name: 'name' in source ? source.name : source.ref,
+        content: source.content,
+      }))
+    : Object.entries(effectiveSources).map(([name, content]) => ({ name, content })))
     .filter(({ name }) => name.endsWith('.xnl'))
     .sort((left, right) => left.name.localeCompare(right.name));
   const sourceNames = sourceEntries.map(({ name }) => name);
@@ -408,6 +438,7 @@ function loadCtrlFlowSources(
     baseUri: options.baseUri,
     dir: options.baseUri ?? '',
     statements: statementEls.map(toNodeSpec),
+    ...(definitionStepForest ? { definitionStepForest } : {}),
     flowContract,
     config,
     configDef,