@openspecui/core 1.1.0 → 1.1.2

package/dist/index.d.mts

@@ -2157,6 +2157,8 @@ declare class OpsxKernel {
   private readonly projectDir;
   private readonly cliExecutor;
   private readonly controller;
+  private warmupPromise;
+  private readonly _streamReady;
   private _statusList;
   private _schemas;
   private _changeIds;
@@ -2176,6 +2178,8 @@ declare class OpsxKernel {
   private _entityControllers;
   constructor(projectDir: string, cliExecutor: CliExecutor);
   warmup(): Promise<void>;
+  waitForWarmup(): Promise<void>;
+  private runWarmup;
   dispose(): void;
   getStatusList(): ChangeStatus[];
   getSchemas(): SchemaInfo[];
@@ -2187,18 +2191,22 @@ declare class OpsxKernel {
   getInstructions(changeId: string, artifact: string, schema?: string): ArtifactInstructions;
   getApplyInstructions(changeId: string, schema?: string): ApplyInstructions;
   getSchemaResolution(name: string): SchemaResolution;
+  peekSchemaResolution(name: string): SchemaResolution | null;
   getSchemaDetail(name: string): SchemaDetail;
+  peekSchemaDetail(name: string): SchemaDetail | null;
   getSchemaFiles(name: string): ChangeFile[];
   getSchemaYaml(name: string): string | null;
   getChangeMetadata(changeId: string): string | null;
   getArtifactOutput(changeId: string, outputPath: string): string | null;
   getGlobArtifactFiles(changeId: string, outputPath: string): GlobArtifactFile[];
   private startStream;
+  private startStreamOnce;
   private warmupSchema;
   private warmupChange;
   private watchSchemaChanges;
   private watchChangeIdChanges;
   private teardownEntity;
+  private clearStreamReadyByPrefix;
   private fetchSchemas;
   private fetchChangeIds;
   private fetchProjectConfig;
@@ -2214,22 +2222,22 @@ declare class OpsxKernel {
   private fetchTemplateContents;
   private fetchChangeMetadata;
   private fetchArtifactOutput;
-  /**
-   * Ensure a per-change status stream exists. If not yet warmed up,
-   * creates the state and starts a stream lazily.
-   */
-  ensureStatus(changeId: string, schema?: string): void;
-  ensureInstructions(changeId: string, artifact: string, schema?: string): void;
-  ensureApplyInstructions(changeId: string, schema?: string): void;
-  ensureArtifactOutput(changeId: string, outputPath: string): void;
-  ensureGlobArtifactFiles(changeId: string, outputPath: string): void;
-  ensureSchemaResolution(name: string): void;
-  ensureSchemaDetail(name: string): void;
-  ensureSchemaFiles(name: string): void;
-  ensureSchemaYaml(name: string): void;
-  ensureTemplates(schema?: string): void;
-  ensureTemplateContents(schema?: string): void;
-  ensureChangeMetadata(changeId: string): void;
+  ensureSchemas(): Promise<void>;
+  ensureChangeIds(): Promise<void>;
+  ensureProjectConfig(): Promise<void>;
+  ensureStatusList(): Promise<void>;
+  ensureStatus(changeId: string, schema?: string): Promise<void>;
+  ensureInstructions(changeId: string, artifact: string, schema?: string): Promise<void>;
+  ensureApplyInstructions(changeId: string, schema?: string): Promise<void>;
+  ensureArtifactOutput(changeId: string, outputPath: string): Promise<void>;
+  ensureGlobArtifactFiles(changeId: string, outputPath: string): Promise<void>;
+  ensureSchemaResolution(name: string): Promise<void>;
+  ensureSchemaDetail(name: string): Promise<void>;
+  ensureSchemaFiles(name: string): Promise<void>;
+  ensureSchemaYaml(name: string): Promise<void>;
+  ensureTemplates(schema?: string): Promise<void>;
+  ensureTemplateContents(schema?: string): Promise<void>;
+  ensureChangeMetadata(changeId: string): Promise<void>;
   private combineSignals;
 }
 //#endregion

package/dist/index.mjs

@@ -3251,6 +3251,8 @@ var OpsxKernel = class {
 	projectDir;
 	cliExecutor;
 	controller = new AbortController();
+	warmupPromise = null;
+	_streamReady = /* @__PURE__ */ new Map();
 	_statusList = new ReactiveState([]);
 	_schemas = new ReactiveState([]);
 	_changeIds = new ReactiveState([]);
@@ -3273,17 +3275,28 @@ var OpsxKernel = class {
 		this.cliExecutor = cliExecutor;
 	}
 	async warmup() {
+		if (this.warmupPromise) return this.warmupPromise;
+		this.warmupPromise = this.runWarmup().catch((error) => {
+			this.warmupPromise = null;
+			throw error;
+		});
+		return this.warmupPromise;
+	}
+	async waitForWarmup() {
+		await this.warmup();
+	}
+	async runWarmup() {
 		const signal = this.controller.signal;
 		await Promise.all([
-			this.startStream(this._schemas, () => this.fetchSchemas(), signal),
-			this.startStream(this._changeIds, () => this.fetchChangeIds(), signal),
-			this.startStream(this._projectConfig, () => this.fetchProjectConfig(), signal)
+			this.startStreamOnce("global:schemas", this._schemas, () => this.fetchSchemas(), signal),
+			this.startStreamOnce("global:change-ids", this._changeIds, () => this.fetchChangeIds(), signal),
+			this.startStreamOnce("global:project-config", this._projectConfig, () => this.fetchProjectConfig(), signal)
 		]);
 		const schemas = this._schemas.get();
 		await Promise.all(schemas.map((s) => this.warmupSchema(s.name, signal)));
 		const changeIds = this._changeIds.get();
 		await Promise.all(changeIds.map((id) => this.warmupChange(id, signal)));
-		await this.startStream(this._statusList, () => this.fetchStatusList(), signal);
+		await this.startStreamOnce("global:status-list", this._statusList, () => this.fetchStatusList(), signal);
 		this.watchSchemaChanges(signal);
 		this.watchChangeIdChanges(signal);
 	}
@@ -3291,6 +3304,8 @@ var OpsxKernel = class {
 		this.controller.abort();
 		for (const ctrl of this._entityControllers.values()) ctrl.abort();
 		this._entityControllers.clear();
+		this._streamReady.clear();
+		this.warmupPromise = null;
 	}
 	getStatusList() {
 		return this._statusList.get();
@@ -3337,11 +3352,21 @@ var OpsxKernel = class {
 		if (!state) throw new Error(`Schema resolution not found for "${name}"`);
 		return state.get();
 	}
+	peekSchemaResolution(name) {
+		const state = this._schemaResolutions.get(name);
+		if (!state) return null;
+		return state.get() ?? null;
+	}
 	getSchemaDetail(name) {
 		const state = this._schemaDetails.get(name);
 		if (!state) throw new Error(`Schema detail not found for "${name}"`);
 		return state.get();
 	}
+	peekSchemaDetail(name) {
+		const state = this._schemaDetails.get(name);
+		if (!state) return null;
+		return state.get() ?? null;
+	}
 	getSchemaFiles(name) {
 		const state = this._schemaFiles.get(name);
 		if (!state) throw new Error(`Schema files not found for "${name}"`);
@@ -3370,7 +3395,7 @@ var OpsxKernel = class {
 		return state.get();
 	}
 	startStream(state, task, signal) {
-		return new Promise((resolve$1) => {
+		return new Promise((resolve$1, reject) => {
 			const context = new ReactiveContext();
 			let first = true;
 			(async () => {
@@ -3382,12 +3407,28 @@ var OpsxKernel = class {
 							resolve$1();
 						}
 					}
-				} catch {}
+				} catch (error) {
+					if (first && !signal.aborted) {
+						reject(error);
+						return;
+					}
+				}
 				if (first) resolve$1();
 			})();
 		});
 	}
+	startStreamOnce(key, state, task, signal) {
+		const existing = this._streamReady.get(key);
+		if (existing) return existing;
+		const ready = this.startStream(state, task, signal).catch((error) => {
+			this._streamReady.delete(key);
+			throw error;
+		});
+		this._streamReady.set(key, ready);
+		return ready;
+	}
 	async warmupSchema(name, parentSignal) {
+		if (this._entityControllers.has(`schema:${name}`)) return;
 		const entityCtrl = new AbortController();
 		this._entityControllers.set(`schema:${name}`, entityCtrl);
 		const signal = this.combineSignals(parentSignal, entityCtrl.signal);
@@ -3400,17 +3441,18 @@ var OpsxKernel = class {
 		if (!this._templates.has("")) this._templates.set("", new ReactiveState({}));
 		if (!this._templateContents.has("")) this._templateContents.set("", new ReactiveState({}));
 		await Promise.all([
-			this.startStream(this._schemaResolutions.get(name), () => this.fetchSchemaResolution(name), signal),
-			this.startStream(this._schemaDetails.get(name), () => this.fetchSchemaDetail(name), signal),
-			this.startStream(this._schemaFiles.get(name), () => this.fetchSchemaFiles(name), signal),
-			this.startStream(this._schemaYamls.get(name), () => this.fetchSchemaYaml(name), signal),
-			this.startStream(this._templates.get(name), () => this.fetchTemplates(name), signal),
-			this.startStream(this._templateContents.get(name), () => this.fetchTemplateContents(name), signal),
-			this.startStream(this._templates.get(""), () => this.fetchTemplates(void 0), signal),
-			this.startStream(this._templateContents.get(""), () => this.fetchTemplateContents(void 0), signal)
+			this.startStreamOnce(`schema:${name}:resolution`, this._schemaResolutions.get(name), () => this.fetchSchemaResolution(name), signal),
+			this.startStreamOnce(`schema:${name}:detail`, this._schemaDetails.get(name), () => this.fetchSchemaDetail(name), signal),
+			this.startStreamOnce(`schema:${name}:files`, this._schemaFiles.get(name), () => this.fetchSchemaFiles(name), signal),
+			this.startStreamOnce(`schema:${name}:yaml`, this._schemaYamls.get(name), () => this.fetchSchemaYaml(name), signal),
+			this.startStreamOnce(`schema:${name}:templates`, this._templates.get(name), () => this.fetchTemplates(name), signal),
+			this.startStreamOnce(`schema:${name}:template-contents`, this._templateContents.get(name), () => this.fetchTemplateContents(name), signal),
+			this.startStreamOnce("schema::templates", this._templates.get(""), () => this.fetchTemplates(void 0), signal),
+			this.startStreamOnce("schema::template-contents", this._templateContents.get(""), () => this.fetchTemplateContents(void 0), signal)
 		]);
 	}
 	async warmupChange(changeId, parentSignal) {
+		if (this._entityControllers.has(`change:${changeId}`)) return;
 		const entityCtrl = new AbortController();
 		this._entityControllers.set(`change:${changeId}`, entityCtrl);
 		const signal = this.combineSignals(parentSignal, entityCtrl.signal);
@@ -3420,22 +3462,22 @@ var OpsxKernel = class {
 		const applyKey = `${changeId}:`;
 		if (!this._applyInstructions.has(applyKey)) this._applyInstructions.set(applyKey, new ReactiveState(null));
 		await Promise.all([
-			this.startStream(this._statuses.get(statusKey), () => this.fetchStatus(changeId, void 0), signal),
-			this.startStream(this._changeMetadata.get(changeId), () => this.fetchChangeMetadata(changeId), signal),
-			this.startStream(this._applyInstructions.get(applyKey), () => this.fetchApplyInstructions(changeId, void 0), signal)
+			this.startStreamOnce(`change:${changeId}:status:`, this._statuses.get(statusKey), () => this.fetchStatus(changeId, void 0), signal),
+			this.startStreamOnce(`change:${changeId}:metadata`, this._changeMetadata.get(changeId), () => this.fetchChangeMetadata(changeId), signal),
+			this.startStreamOnce(`change:${changeId}:apply:`, this._applyInstructions.get(applyKey), () => this.fetchApplyInstructions(changeId, void 0), signal)
 		]);
 		const status = this._statuses.get(statusKey)?.get();
 		if (status?.artifacts) await Promise.all(status.artifacts.map(async (artifact) => {
 			const instrKey = `${changeId}:${artifact.id}:`;
 			if (!this._instructions.has(instrKey)) this._instructions.set(instrKey, new ReactiveState(null));
-			await this.startStream(this._instructions.get(instrKey), () => this.fetchInstructions(changeId, artifact.id, void 0), signal);
+			await this.startStreamOnce(`change:${changeId}:instructions:${artifact.id}:`, this._instructions.get(instrKey), () => this.fetchInstructions(changeId, artifact.id, void 0), signal);
 			const outputKey = `${changeId}:${artifact.outputPath}`;
 			if (!this._artifactOutputs.has(outputKey)) this._artifactOutputs.set(outputKey, new ReactiveState(null));
-			await this.startStream(this._artifactOutputs.get(outputKey), () => this.fetchArtifactOutput(changeId, artifact.outputPath), signal);
+			await this.startStreamOnce(`change:${changeId}:output:${artifact.outputPath}`, this._artifactOutputs.get(outputKey), () => this.fetchArtifactOutput(changeId, artifact.outputPath), signal);
 			if (artifact.outputPath.includes("*") || artifact.outputPath.includes("?") || artifact.outputPath.includes("[")) {
 				const globKey = `${changeId}:${artifact.outputPath}`;
 				if (!this._globArtifactFiles.has(globKey)) this._globArtifactFiles.set(globKey, new ReactiveState([]));
-				await this.startStream(this._globArtifactFiles.get(globKey), () => readGlobArtifactFiles(this.projectDir, changeId, artifact.outputPath), signal);
+				await this.startStreamOnce(`change:${changeId}:glob:${artifact.outputPath}`, this._globArtifactFiles.get(globKey), () => readGlobArtifactFiles(this.projectDir, changeId, artifact.outputPath), signal);
 			}
 		}));
 	}
@@ -3446,7 +3488,7 @@ var OpsxKernel = class {
 			try {
 				for await (const schemas of context.stream(() => Promise.resolve(this._schemas.get()), signal)) {
 					const newNames = new Set(schemas.map((s) => s.name));
-					for (const name of newNames) if (!prevNames.has(name)) this.warmupSchema(name, signal);
+					for (const name of newNames) if (!prevNames.has(name)) this.warmupSchema(name, signal).catch(() => {});
 					for (const name of prevNames) if (!newNames.has(name)) {
 						this.teardownEntity(`schema:${name}`);
 						this._schemaResolutions.delete(name);
@@ -3455,6 +3497,7 @@ var OpsxKernel = class {
 						this._schemaYamls.delete(name);
 						this._templates.delete(name);
 						this._templateContents.delete(name);
+						this.clearStreamReadyByPrefix(`schema:${name}:`);
 					}
 					prevNames = newNames;
 				}
@@ -3468,15 +3511,33 @@ var OpsxKernel = class {
 			try {
 				for await (const ids of context.stream(() => Promise.resolve(this._changeIds.get()), signal)) {
 					const newIds = new Set(ids);
-					for (const id of newIds) if (!prevIds.has(id)) this.warmupChange(id, signal);
+					for (const id of newIds) if (!prevIds.has(id)) this.warmupChange(id, signal).catch(() => {});
 					for (const id of prevIds) if (!newIds.has(id)) {
 						this.teardownEntity(`change:${id}`);
-						for (const key of this._statuses.keys()) if (key.startsWith(`${id}:`)) this._statuses.delete(key);
-						for (const key of this._instructions.keys()) if (key.startsWith(`${id}:`)) this._instructions.delete(key);
-						for (const key of this._applyInstructions.keys()) if (key.startsWith(`${id}:`)) this._applyInstructions.delete(key);
+						for (const key of this._statuses.keys()) if (key.startsWith(`${id}:`)) {
+							this._statuses.delete(key);
+							this._streamReady.delete(`change:${id}:status:${key.slice(id.length + 1)}`);
+						}
+						for (const key of this._instructions.keys()) if (key.startsWith(`${id}:`)) {
+							this._instructions.delete(key);
+							const suffix = key.slice(id.length + 1);
+							this._streamReady.delete(`change:${id}:instructions:${suffix}`);
+						}
+						for (const key of this._applyInstructions.keys()) if (key.startsWith(`${id}:`)) {
+							this._applyInstructions.delete(key);
+							this._streamReady.delete(`change:${id}:apply:${key.slice(id.length + 1)}`);
+						}
 						this._changeMetadata.delete(id);
-						for (const key of this._artifactOutputs.keys()) if (key.startsWith(`${id}:`)) this._artifactOutputs.delete(key);
-						for (const key of this._globArtifactFiles.keys()) if (key.startsWith(`${id}:`)) this._globArtifactFiles.delete(key);
+						this._streamReady.delete(`change:${id}:metadata`);
+						for (const key of this._artifactOutputs.keys()) if (key.startsWith(`${id}:`)) {
+							this._artifactOutputs.delete(key);
+							this._streamReady.delete(`change:${id}:output:${key.slice(id.length + 1)}`);
+						}
+						for (const key of this._globArtifactFiles.keys()) if (key.startsWith(`${id}:`)) {
+							this._globArtifactFiles.delete(key);
+							this._streamReady.delete(`change:${id}:glob:${key.slice(id.length + 1)}`);
+						}
+						this.clearStreamReadyByPrefix(`change:${id}:`);
 					}
 					prevIds = newIds;
 				}
@@ -3490,6 +3551,9 @@ var OpsxKernel = class {
 			this._entityControllers.delete(key);
 		}
 	}
+	clearStreamReadyByPrefix(prefix) {
+		for (const key of this._streamReady.keys()) if (key.startsWith(prefix)) this._streamReady.delete(key);
+	}
 	async fetchSchemas() {
 		await touchOpsxProjectDeps(this.projectDir);
 		const result = await this.cliExecutor.schemas();
@@ -3524,13 +3588,10 @@ var OpsxKernel = class {
 		return status;
 	}
 	async fetchStatusList() {
+		await this.ensureChangeIds();
 		const changeIds = this._changeIds.get();
-		return Promise.all(changeIds.map((id) => {
-			const key = `${id}:`;
-			const state = this._statuses.get(key);
-			if (state) return Promise.resolve(state.get());
-			return this.fetchStatus(id);
-		}));
+		await Promise.all(changeIds.map((id) => this.ensureStatus(id)));
+		return changeIds.map((id) => this.getStatus(id));
 	}
 	async fetchInstructions(changeId, artifact, schema) {
 		await touchOpsxProjectDeps(this.projectDir);
@@ -3570,18 +3631,21 @@ var OpsxKernel = class {
 	}
 	async fetchSchemaDetail(name) {
 		await touchOpsxProjectDeps(this.projectDir);
-		const schemaPath = join$1((await this.fetchSchemaResolution(name)).path, "schema.yaml");
+		await this.ensureSchemaResolution(name);
+		const schemaPath = join$1(this.getSchemaResolution(name).path, "schema.yaml");
 		const content = await reactiveReadFile(schemaPath);
 		if (!content) throw new Error(`schema.yaml not found at ${schemaPath}`);
 		return parseSchemaYamlInline(content);
 	}
 	async fetchSchemaFiles(name) {
 		await touchOpsxProjectDeps(this.projectDir);
-		return readEntriesUnderRoot((await this.fetchSchemaResolution(name)).path);
+		await this.ensureSchemaResolution(name);
+		return readEntriesUnderRoot(this.getSchemaResolution(name).path);
 	}
 	async fetchSchemaYaml(name) {
 		await touchOpsxProjectDeps(this.projectDir);
-		return reactiveReadFile(join$1((await this.fetchSchemaResolution(name)).path, "schema.yaml"));
+		await this.ensureSchemaResolution(name);
+		return reactiveReadFile(join$1(this.getSchemaResolution(name).path, "schema.yaml"));
 	}
 	async fetchTemplates(schema) {
 		await touchOpsxProjectDeps(this.projectDir);
@@ -3590,7 +3654,8 @@ var OpsxKernel = class {
 		return parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
 	}
 	async fetchTemplateContents(schema) {
-		const templates = await this.fetchTemplates(schema);
+		await this.ensureTemplates(schema);
+		const templates = this.getTemplates(schema);
 		const entries = await Promise.all(Object.entries(templates).map(async ([artifactId, info]) => {
 			return [artifactId, {
 				content: await reactiveReadFile(info.path),
@@ -3606,88 +3671,72 @@ var OpsxKernel = class {
 	async fetchArtifactOutput(changeId, outputPath) {
 		return reactiveReadFile(join$1(this.projectDir, "openspec", "changes", changeId, outputPath));
 	}
-	/**
-	* Ensure a per-change status stream exists. If not yet warmed up,
-	* creates the state and starts a stream lazily.
-	*/
-	ensureStatus(changeId, schema) {
+	async ensureSchemas() {
+		await this.startStreamOnce("global:schemas", this._schemas, () => this.fetchSchemas(), this.controller.signal);
+	}
+	async ensureChangeIds() {
+		await this.startStreamOnce("global:change-ids", this._changeIds, () => this.fetchChangeIds(), this.controller.signal);
+	}
+	async ensureProjectConfig() {
+		await this.startStreamOnce("global:project-config", this._projectConfig, () => this.fetchProjectConfig(), this.controller.signal);
+	}
+	async ensureStatusList() {
+		await this.startStreamOnce("global:status-list", this._statusList, () => this.fetchStatusList(), this.controller.signal);
+	}
+	async ensureStatus(changeId, schema) {
 		const key = `${changeId}:${schema ?? ""}`;
-		if (!this._statuses.has(key)) {
-			this._statuses.set(key, new ReactiveState(null));
-			this.startStream(this._statuses.get(key), () => this.fetchStatus(changeId, schema), this.controller.signal);
-		}
+		if (!this._statuses.has(key)) this._statuses.set(key, new ReactiveState(null));
+		await this.startStreamOnce(`change:${changeId}:status:${schema ?? ""}`, this._statuses.get(key), () => this.fetchStatus(changeId, schema), this.controller.signal);
 	}
-	ensureInstructions(changeId, artifact, schema) {
+	async ensureInstructions(changeId, artifact, schema) {
 		const key = `${changeId}:${artifact}:${schema ?? ""}`;
-		if (!this._instructions.has(key)) {
-			this._instructions.set(key, new ReactiveState(null));
-			this.startStream(this._instructions.get(key), () => this.fetchInstructions(changeId, artifact, schema), this.controller.signal);
-		}
+		if (!this._instructions.has(key)) this._instructions.set(key, new ReactiveState(null));
+		await this.startStreamOnce(`change:${changeId}:instructions:${artifact}:${schema ?? ""}`, this._instructions.get(key), () => this.fetchInstructions(changeId, artifact, schema), this.controller.signal);
 	}
-	ensureApplyInstructions(changeId, schema) {
+	async ensureApplyInstructions(changeId, schema) {
 		const key = `${changeId}:${schema ?? ""}`;
-		if (!this._applyInstructions.has(key)) {
-			this._applyInstructions.set(key, new ReactiveState(null));
-			this.startStream(this._applyInstructions.get(key), () => this.fetchApplyInstructions(changeId, schema), this.controller.signal);
-		}
+		if (!this._applyInstructions.has(key)) this._applyInstructions.set(key, new ReactiveState(null));
+		await this.startStreamOnce(`change:${changeId}:apply:${schema ?? ""}`, this._applyInstructions.get(key), () => this.fetchApplyInstructions(changeId, schema), this.controller.signal);
 	}
-	ensureArtifactOutput(changeId, outputPath) {
+	async ensureArtifactOutput(changeId, outputPath) {
 		const key = `${changeId}:${outputPath}`;
-		if (!this._artifactOutputs.has(key)) {
-			this._artifactOutputs.set(key, new ReactiveState(null));
-			this.startStream(this._artifactOutputs.get(key), () => this.fetchArtifactOutput(changeId, outputPath), this.controller.signal);
-		}
+		if (!this._artifactOutputs.has(key)) this._artifactOutputs.set(key, new ReactiveState(null));
+		await this.startStreamOnce(`change:${changeId}:output:${outputPath}`, this._artifactOutputs.get(key), () => this.fetchArtifactOutput(changeId, outputPath), this.controller.signal);
 	}
-	ensureGlobArtifactFiles(changeId, outputPath) {
+	async ensureGlobArtifactFiles(changeId, outputPath) {
 		const key = `${changeId}:${outputPath}`;
-		if (!this._globArtifactFiles.has(key)) {
-			this._globArtifactFiles.set(key, new ReactiveState([]));
-			this.startStream(this._globArtifactFiles.get(key), () => readGlobArtifactFiles(this.projectDir, changeId, outputPath), this.controller.signal);
-		}
+		if (!this._globArtifactFiles.has(key)) this._globArtifactFiles.set(key, new ReactiveState([]));
+		await this.startStreamOnce(`change:${changeId}:glob:${outputPath}`, this._globArtifactFiles.get(key), () => readGlobArtifactFiles(this.projectDir, changeId, outputPath), this.controller.signal);
 	}
-	ensureSchemaResolution(name) {
-		if (!this._schemaResolutions.has(name)) {
-			this._schemaResolutions.set(name, new ReactiveState(null));
-			this.startStream(this._schemaResolutions.get(name), () => this.fetchSchemaResolution(name), this.controller.signal);
-		}
+	async ensureSchemaResolution(name) {
+		if (!this._schemaResolutions.has(name)) this._schemaResolutions.set(name, new ReactiveState(null));
+		await this.startStreamOnce(`schema:${name}:resolution`, this._schemaResolutions.get(name), () => this.fetchSchemaResolution(name), this.controller.signal);
 	}
-	ensureSchemaDetail(name) {
-		if (!this._schemaDetails.has(name)) {
-			this._schemaDetails.set(name, new ReactiveState(null));
-			this.startStream(this._schemaDetails.get(name), () => this.fetchSchemaDetail(name), this.controller.signal);
-		}
+	async ensureSchemaDetail(name) {
+		if (!this._schemaDetails.has(name)) this._schemaDetails.set(name, new ReactiveState(null));
+		await this.startStreamOnce(`schema:${name}:detail`, this._schemaDetails.get(name), () => this.fetchSchemaDetail(name), this.controller.signal);
 	}
-	ensureSchemaFiles(name) {
-		if (!this._schemaFiles.has(name)) {
-			this._schemaFiles.set(name, new ReactiveState([]));
-			this.startStream(this._schemaFiles.get(name), () => this.fetchSchemaFiles(name), this.controller.signal);
-		}
+	async ensureSchemaFiles(name) {
+		if (!this._schemaFiles.has(name)) this._schemaFiles.set(name, new ReactiveState([]));
+		await this.startStreamOnce(`schema:${name}:files`, this._schemaFiles.get(name), () => this.fetchSchemaFiles(name), this.controller.signal);
 	}
-	ensureSchemaYaml(name) {
-		if (!this._schemaYamls.has(name)) {
-			this._schemaYamls.set(name, new ReactiveState(null));
-			this.startStream(this._schemaYamls.get(name), () => this.fetchSchemaYaml(name), this.controller.signal);
-		}
+	async ensureSchemaYaml(name) {
+		if (!this._schemaYamls.has(name)) this._schemaYamls.set(name, new ReactiveState(null));
+		await this.startStreamOnce(`schema:${name}:yaml`, this._schemaYamls.get(name), () => this.fetchSchemaYaml(name), this.controller.signal);
 	}
-	ensureTemplates(schema) {
+	async ensureTemplates(schema) {
 		const key = schema ?? "";
-		if (!this._templates.has(key)) {
-			this._templates.set(key, new ReactiveState({}));
-			this.startStream(this._templates.get(key), () => this.fetchTemplates(schema), this.controller.signal);
-		}
+		if (!this._templates.has(key)) this._templates.set(key, new ReactiveState({}));
+		await this.startStreamOnce(`schema:${key}:templates`, this._templates.get(key), () => this.fetchTemplates(schema), this.controller.signal);
 	}
-	ensureTemplateContents(schema) {
+	async ensureTemplateContents(schema) {
 		const key = schema ?? "";
-		if (!this._templateContents.has(key)) {
-			this._templateContents.set(key, new ReactiveState({}));
-			this.startStream(this._templateContents.get(key), () => this.fetchTemplateContents(schema), this.controller.signal);
-		}
+		if (!this._templateContents.has(key)) this._templateContents.set(key, new ReactiveState({}));
+		await this.startStreamOnce(`schema:${key}:template-contents`, this._templateContents.get(key), () => this.fetchTemplateContents(schema), this.controller.signal);
 	}
-	ensureChangeMetadata(changeId) {
-		if (!this._changeMetadata.has(changeId)) {
-			this._changeMetadata.set(changeId, new ReactiveState(null));
-			this.startStream(this._changeMetadata.get(changeId), () => this.fetchChangeMetadata(changeId), this.controller.signal);
-		}
+	async ensureChangeMetadata(changeId) {
+		if (!this._changeMetadata.has(changeId)) this._changeMetadata.set(changeId, new ReactiveState(null));
+		await this.startStreamOnce(`change:${changeId}:metadata`, this._changeMetadata.get(changeId), () => this.fetchChangeMetadata(changeId), this.controller.signal);
 	}
 	combineSignals(a, b) {
 		const ctrl = new AbortController();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",