@optique/core 1.3.0-dev.2381 → 1.3.0-dev.2385

package/dist/constructs.cjs

@@ -59,6 +59,26 @@ function filterPreCompletedRuntimeNodes(nodes, preCompletedKeys) {
 	});
 }
 /**
+* Filters a construct's runtime nodes for the effectful scheduling pass.
+*
+* A settled Phase 1 pre-completion excludes an *effectful* node: its
+* completion already ran and must not run again.  Structural
+* (non-effectful) nodes always stay in the pass, whether pre-completed
+* or not: the scheduler re-registers their extracted values so that
+* registration order follows declaration order across structural and
+* effectful occurrences of a shared source.
+*/
+function filterSchedulableRuntimeNodes(nodes, preCompleted) {
+	const settledKeys = settledPreCompletedKeys(preCompleted);
+	if (settledKeys.size < 1) return nodes;
+	return nodes.filter((node) => {
+		if (node.parser.dependencyMetadata?.source?.completeSource == null) return true;
+		const segment = node.path.at(-1);
+		if (typeof segment === "number") return !settledKeys.has(String(segment));
+		return segment == null || !settledKeys.has(segment);
+	});
+}
+/**
 * Runs the effectful source completion pass for a construct's direct
 * children and merges the completed results into the construct's
 * pre-completed cache so its final completion phase reuses them instead
@@ -130,7 +150,8 @@ function isDeferredCompletionResult(result) {
 function settledPreCompletedKeys(preCompleted) {
 	const keys = /* @__PURE__ */ new Set();
 	for (const [key, result] of preCompleted) {
-		if (isDeferredCompletionResult(result)) continue;
+		const completion = require_internal_dependency.isDependencySourceState(result) ? result.result : result;
+		if (isDeferredCompletionResult(completion)) continue;
 		keys.add(key);
 	}
 	return keys;
@@ -145,7 +166,10 @@ function settledPreCompletedKeys(preCompleted) {
 * immediately.
 */
 function firstPreCompletedFailure(preCompleted) {
-	for (const result of preCompleted.values()) if (typeof result === "object" && result !== null && "success" in result && result.success === false && "error" in result) return result.error;
+	for (const result of preCompleted.values()) {
+		const completion = require_internal_dependency.isDependencySourceState(result) ? result.result : result;
+		if (typeof completion === "object" && completion !== null && "success" in completion && completion.success === false && "error" in completion) return completion.error;
+	}
 	return void 0;
 }
 async function scheduleEffectfulSourceCompletions(nodes, state, runtime, exec, preCompleted, demandNodes) {
@@ -2463,7 +2487,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromPairs(asyncParserPairs, annotatedState, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), annotatedState, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), annotatedState, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return effectfulFailure;
 				const resolvedFieldStates = await require_dependency_runtime.resolveStateWithRuntimeAsync(annotatedState, runtime);
 				const result = {};
@@ -2589,7 +2613,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromPairs(asyncParserPairs, annotatedState, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), annotatedState, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), annotatedState, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const resolvedFieldStates = await require_dependency_runtime.resolveStateWithRuntimeAsync(annotatedState, runtime);
 				const result = {};
@@ -3012,7 +3036,7 @@ function createSeqComplete(parsers, combinedMode) {
 		const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 		const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 		await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 		if (effectfulFailure != null) return effectfulFailure;
 		const phase3Exec = {
 			...childExec,
@@ -3507,7 +3531,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return effectfulFailure;
 				const phase3Exec = {
 					...childExec,
@@ -3595,7 +3619,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,
@@ -3861,7 +3885,7 @@ function seq(...rawArgs) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,
@@ -5443,7 +5467,7 @@ function concat(...parsers) {
 		const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 		const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 		await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 		if (effectfulFailure != null) return effectfulFailure;
 		const phase3Exec = {
 			...childExec,
@@ -5551,7 +5575,7 @@ function concat(...parsers) {
 				const allRuntimeNodes = require_dependency_runtime.buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await require_dependency_runtime.collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,

package/dist/constructs.js

@@ -59,6 +59,26 @@ function filterPreCompletedRuntimeNodes(nodes, preCompletedKeys) {
 	});
 }
 /**
+* Filters a construct's runtime nodes for the effectful scheduling pass.
+*
+* A settled Phase 1 pre-completion excludes an *effectful* node: its
+* completion already ran and must not run again.  Structural
+* (non-effectful) nodes always stay in the pass, whether pre-completed
+* or not: the scheduler re-registers their extracted values so that
+* registration order follows declaration order across structural and
+* effectful occurrences of a shared source.
+*/
+function filterSchedulableRuntimeNodes(nodes, preCompleted) {
+	const settledKeys = settledPreCompletedKeys(preCompleted);
+	if (settledKeys.size < 1) return nodes;
+	return nodes.filter((node) => {
+		if (node.parser.dependencyMetadata?.source?.completeSource == null) return true;
+		const segment = node.path.at(-1);
+		if (typeof segment === "number") return !settledKeys.has(String(segment));
+		return segment == null || !settledKeys.has(segment);
+	});
+}
+/**
 * Runs the effectful source completion pass for a construct's direct
 * children and merges the completed results into the construct's
 * pre-completed cache so its final completion phase reuses them instead
@@ -130,7 +150,8 @@ function isDeferredCompletionResult(result) {
 function settledPreCompletedKeys(preCompleted) {
 	const keys = /* @__PURE__ */ new Set();
 	for (const [key, result] of preCompleted) {
-		if (isDeferredCompletionResult(result)) continue;
+		const completion = isDependencySourceState(result) ? result.result : result;
+		if (isDeferredCompletionResult(completion)) continue;
 		keys.add(key);
 	}
 	return keys;
@@ -145,7 +166,10 @@ function settledPreCompletedKeys(preCompleted) {
 * immediately.
 */
 function firstPreCompletedFailure(preCompleted) {
-	for (const result of preCompleted.values()) if (typeof result === "object" && result !== null && "success" in result && result.success === false && "error" in result) return result.error;
+	for (const result of preCompleted.values()) {
+		const completion = isDependencySourceState(result) ? result.result : result;
+		if (typeof completion === "object" && completion !== null && "success" in completion && completion.success === false && "error" in completion) return completion.error;
+	}
 	return void 0;
 }
 async function scheduleEffectfulSourceCompletions(nodes, state, runtime, exec, preCompleted, demandNodes) {
@@ -2463,7 +2487,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = buildRuntimeNodesFromPairs(asyncParserPairs, annotatedState, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), annotatedState, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), annotatedState, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return effectfulFailure;
 				const resolvedFieldStates = await resolveStateWithRuntimeAsync(annotatedState, runtime);
 				const result = {};
@@ -2589,7 +2613,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = buildRuntimeNodesFromPairs(asyncParserPairs, annotatedState, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), annotatedState, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), annotatedState, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const resolvedFieldStates = await resolveStateWithRuntimeAsync(annotatedState, runtime);
 				const result = {};
@@ -3012,7 +3036,7 @@ function createSeqComplete(parsers, combinedMode) {
 		const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 		const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 		await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 		if (effectfulFailure != null) return effectfulFailure;
 		const phase3Exec = {
 			...childExec,
@@ -3507,7 +3531,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return effectfulFailure;
 				const phase3Exec = {
 					...childExec,
@@ -3595,7 +3619,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 				const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,
@@ -3861,7 +3885,7 @@ function seq(...rawArgs) {
 				const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,
@@ -5443,7 +5467,7 @@ function concat(...parsers) {
 		const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 		const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 		await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+		const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 		if (effectfulFailure != null) return effectfulFailure;
 		const phase3Exec = {
 			...childExec,
@@ -5551,7 +5575,7 @@ function concat(...parsers) {
 				const allRuntimeNodes = buildRuntimeNodesFromArray(parsers, stateArray, exec?.path);
 				const runtimeNodes = filterPreCompletedRuntimeNodes(allRuntimeNodes, new Set(preCompleted.keys()));
 				await collectExplicitSourceValuesAsync(runtimeNodes, runtime);
-				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterPreCompletedRuntimeNodes(allRuntimeNodes, settledPreCompletedKeys(preCompleted)), stateArray, runtime, childExec, preCompleted);
+				const effectfulFailure = await scheduleEffectfulSourceCompletions(filterSchedulableRuntimeNodes(allRuntimeNodes, preCompleted), stateArray, runtime, childExec, preCompleted);
 				if (effectfulFailure != null) return null;
 				const phase3Exec = {
 					...childExec,

package/dist/dependency-runtime.cjs

@@ -627,15 +627,16 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 	}
 	const schedulable = nodes.filter((node) => node.parser.dependencyMetadata?.source?.completeSource != null);
 	if (schedulable.length === 0) return empty;
-	const preexisting = /* @__PURE__ */ new Set();
-	for (const node of schedulable) {
-		const source = node.parser.dependencyMetadata?.source;
-		if (source != null && runtime.hasSource(source.sourceId) && session?.effectfulSources.has(source.sourceId) !== true) preexisting.add(source.sourceId);
-	}
 	const completed = [];
-	for (const node of schedulable) {
+	for (const node of nodes) {
 		const source = node.parser.dependencyMetadata?.source;
-		if (source?.completeSource == null) continue;
+		if (source == null) continue;
+		if (source.completeSource == null) {
+			if (source.extractSourceValue == null || (options?.isReusable?.(node) ?? true) === false) continue;
+			const extracted = await source.extractSourceValue(node.state);
+			if (extracted?.success === true && extracted.value !== void 0) runtime.registerSource(source.sourceId, extracted.value);
+			continue;
+		}
 		const pathKey = serializeSchedulingPath(node.path);
 		const priorResult = session?.completedByPath.get(pathKey);
 		if (priorResult != null) {
@@ -645,7 +646,6 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 			});
 			continue;
 		}
-		if (preexisting.has(source.sourceId)) continue;
 		const reusable = source.preservesSourceValue && (options?.isReusable?.(node) ?? true);
 		if (!reusable && session == null) continue;
 		const childExec = {
@@ -679,15 +679,7 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 * length-prefixed segments so no separator escaping is needed.
 */
 function serializeSchedulingPath(path) {
-	return path.map((segment) => {
-		if (typeof segment === "symbol") {
-			const key = stableSymbolKey(segment);
-			return `y${key.length}:${key}`;
-		}
-		const tag = typeof segment === "number" ? "n" : "s";
-		const text = String(segment);
-		return `${tag}${text.length}:${text}`;
-	}).join("");
+	return path.map(serializePathSegment).join("");
 }
 /**
 * Checks if a value is a plain object (not a class instance) for the

package/dist/dependency-runtime.js

@@ -627,15 +627,16 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 	}
 	const schedulable = nodes.filter((node) => node.parser.dependencyMetadata?.source?.completeSource != null);
 	if (schedulable.length === 0) return empty;
-	const preexisting = /* @__PURE__ */ new Set();
-	for (const node of schedulable) {
-		const source = node.parser.dependencyMetadata?.source;
-		if (source != null && runtime.hasSource(source.sourceId) && session?.effectfulSources.has(source.sourceId) !== true) preexisting.add(source.sourceId);
-	}
 	const completed = [];
-	for (const node of schedulable) {
+	for (const node of nodes) {
 		const source = node.parser.dependencyMetadata?.source;
-		if (source?.completeSource == null) continue;
+		if (source == null) continue;
+		if (source.completeSource == null) {
+			if (source.extractSourceValue == null || (options?.isReusable?.(node) ?? true) === false) continue;
+			const extracted = await source.extractSourceValue(node.state);
+			if (extracted?.success === true && extracted.value !== void 0) runtime.registerSource(source.sourceId, extracted.value);
+			continue;
+		}
 		const pathKey = serializeSchedulingPath(node.path);
 		const priorResult = session?.completedByPath.get(pathKey);
 		if (priorResult != null) {
@@ -645,7 +646,6 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 			});
 			continue;
 		}
-		if (preexisting.has(source.sourceId)) continue;
 		const reusable = source.preservesSourceValue && (options?.isReusable?.(node) ?? true);
 		if (!reusable && session == null) continue;
 		const childExec = {
@@ -679,15 +679,7 @@ async function completeEffectfulSourcesAsync(nodes, state, runtime, exec, option
 * length-prefixed segments so no separator escaping is needed.
 */
 function serializeSchedulingPath(path) {
-	return path.map((segment) => {
-		if (typeof segment === "symbol") {
-			const key = stableSymbolKey(segment);
-			return `y${key.length}:${key}`;
-		}
-		const tag = typeof segment === "number" ? "n" : "s";
-		const text = String(segment);
-		return `${tag}${text.length}:${text}`;
-	}).join("");
+	return path.map(serializePathSegment).join("");
 }
 /**
 * Checks if a value is a plain object (not a class instance) for the

package/dist/facade.cjs

@@ -126,6 +126,31 @@ function withEffectfulSessionOption(options, session) {
 		[effectfulSessionOptionsKey]: session
 	};
 }
+/**
+* Creates the run-scoped effectful completion sessions shared by a
+* `runWith()` two-phase run, so an effectful source (e.g., a prompt)
+* runs at most once per invocation.  The seed pass uses the demand-only
+* policy: an effectful source completes there only when a phase-one
+* consumer demands its value; others defer to the final pass.  The
+* final pass shares the run-scoped results cache and demand set, but
+* recomputes structural precedence from scratch: phase-two annotations
+* may introduce environment/configuration values that must win over a
+* cached seed prompt answer, so the effectful-source markers do not
+* carry over.
+*/
+function createRunWithSessions() {
+	const seedSession = require_internal_parser.createEffectfulCompletionSession("demand-only");
+	const finalSession = {
+		...seedSession,
+		policy: "eager",
+		effectfulSources: /* @__PURE__ */ new Set(),
+		completedByPath: /* @__PURE__ */ new Map()
+	};
+	return {
+		seedSession,
+		finalSession
+	};
+}
 function createCompleteExec(exec, context, session) {
 	const runtime = require_dependency_runtime.createDependencyRuntimeContext();
 	return {
@@ -1615,13 +1640,7 @@ async function runWithBody(parser, programName, contexts, args, options) {
 		if (parser.mode === "async") return runParser(augmentedParser1, programName, args, options);
 		return Promise.resolve(runParser(augmentedParser1, programName, args, options));
 	}
-	const seedSession = require_internal_parser.createEffectfulCompletionSession("demand-only");
-	const finalSession = {
-		...seedSession,
-		policy: "eager",
-		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
-	};
+	const { seedSession, finalSession } = createRunWithSessions();
 	const sessionOptions = withEffectfulSessionOption(options, finalSession);
 	const firstPassSeed = await require_mode_dispatch.dispatchByMode(parser.mode, () => extractPhase2SeedSync(augmentedParser1, args, seedSession), () => extractPhase2SeedAsync(augmentedParser1, args, seedSession));
 	if (firstPassSeed == null) {
@@ -1738,13 +1757,7 @@ function runWithSyncBody(parser, programName, contexts, args, options) {
 	}
 	const augmentedParser1 = injectAnnotationsIntoParser(parser, phase1Annotations);
 	if (!needsTwoPhase) return runParser(augmentedParser1, programName, args, options);
-	const seedSession = require_internal_parser.createEffectfulCompletionSession("demand-only");
-	const finalSession = {
-		...seedSession,
-		policy: "eager",
-		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
-	};
+	const { seedSession, finalSession } = createRunWithSessions();
 	const sessionOptions = withEffectfulSessionOption(options, finalSession);
 	const firstPassSeed = extractPhase2SeedSync(augmentedParser1, args, seedSession);
 	if (firstPassSeed == null) {

package/dist/facade.js

@@ -126,6 +126,31 @@ function withEffectfulSessionOption(options, session) {
 		[effectfulSessionOptionsKey]: session
 	};
 }
+/**
+* Creates the run-scoped effectful completion sessions shared by a
+* `runWith()` two-phase run, so an effectful source (e.g., a prompt)
+* runs at most once per invocation.  The seed pass uses the demand-only
+* policy: an effectful source completes there only when a phase-one
+* consumer demands its value; others defer to the final pass.  The
+* final pass shares the run-scoped results cache and demand set, but
+* recomputes structural precedence from scratch: phase-two annotations
+* may introduce environment/configuration values that must win over a
+* cached seed prompt answer, so the effectful-source markers do not
+* carry over.
+*/
+function createRunWithSessions() {
+	const seedSession = createEffectfulCompletionSession("demand-only");
+	const finalSession = {
+		...seedSession,
+		policy: "eager",
+		effectfulSources: /* @__PURE__ */ new Set(),
+		completedByPath: /* @__PURE__ */ new Map()
+	};
+	return {
+		seedSession,
+		finalSession
+	};
+}
 function createCompleteExec(exec, context, session) {
 	const runtime = createDependencyRuntimeContext();
 	return {
@@ -1615,13 +1640,7 @@ async function runWithBody(parser, programName, contexts, args, options) {
 		if (parser.mode === "async") return runParser(augmentedParser1, programName, args, options);
 		return Promise.resolve(runParser(augmentedParser1, programName, args, options));
 	}
-	const seedSession = createEffectfulCompletionSession("demand-only");
-	const finalSession = {
-		...seedSession,
-		policy: "eager",
-		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
-	};
+	const { seedSession, finalSession } = createRunWithSessions();
 	const sessionOptions = withEffectfulSessionOption(options, finalSession);
 	const firstPassSeed = await dispatchByMode(parser.mode, () => extractPhase2SeedSync(augmentedParser1, args, seedSession), () => extractPhase2SeedAsync(augmentedParser1, args, seedSession));
 	if (firstPassSeed == null) {
@@ -1738,13 +1757,7 @@ function runWithSyncBody(parser, programName, contexts, args, options) {
 	}
 	const augmentedParser1 = injectAnnotationsIntoParser(parser, phase1Annotations);
 	if (!needsTwoPhase) return runParser(augmentedParser1, programName, args, options);
-	const seedSession = createEffectfulCompletionSession("demand-only");
-	const finalSession = {
-		...seedSession,
-		policy: "eager",
-		effectfulSources: /* @__PURE__ */ new Set(),
-		completedByPath: /* @__PURE__ */ new Map()
-	};
+	const { seedSession, finalSession } = createRunWithSessions();
 	const sessionOptions = withEffectfulSessionOption(options, finalSession);
 	const firstPassSeed = extractPhase2SeedSync(augmentedParser1, args, seedSession);
 	if (firstPassSeed == null) {

package/dist/internal/parser.d.cts

@@ -419,9 +419,9 @@ type ExecutionPhase = "parse" | "precomplete" | "resolve" | "complete" | "sugges
  * run, shared by the phase-two seed pass and the final pass) and threaded
  * through {@link ExecutionContext}.  It guarantees that an effectful source
  * completion runs at most once per run: the completion result is cached by
- * dependency source ID, and a cache hit is returned without repeating the
- * effect.  Results never leak between runs because the session is discarded
- * when the run ends.
+ * completion occurrence (see {@link EffectfulCompletionSession.results}),
+ * and a cache hit is returned without repeating the effect.  Results never
+ * leak between runs because the session is discarded when the run ends.
  *
  * @internal
  * @since 1.3.0

package/dist/internal/parser.d.ts

@@ -419,9 +419,9 @@ type ExecutionPhase = "parse" | "precomplete" | "resolve" | "complete" | "sugges
  * run, shared by the phase-two seed pass and the final pass) and threaded
  * through {@link ExecutionContext}.  It guarantees that an effectful source
  * completion runs at most once per run: the completion result is cached by
- * dependency source ID, and a cache hit is returned without repeating the
- * effect.  Results never leak between runs because the session is discarded
- * when the run ends.
+ * completion occurrence (see {@link EffectfulCompletionSession.results}),
+ * and a cache hit is returned without repeating the effect.  Results never
+ * leak between runs because the session is discarded when the run ends.
  *
  * @internal
  * @since 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.3.0-dev.2381",
+  "version": "1.3.0-dev.2385",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -221,7 +221,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.3.0-dev.2381+b37c0393",
+    "@optique/env": "1.3.0-dev.2385+011936e3",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",