@openspecui/core 1.2.0 → 1.6.0

package/dist/index.mjs

@@ -1,12 +1,13 @@
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DYIjMsbM.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { readFile as readFile$1, readdir, stat } from "node:fs/promises";
 import { dirname as dirname$1, join as join$1, matchesGlob, relative, resolve, sep } from "node:path";
-import { existsSync, realpathSync, utimesSync } from "node:fs";
+import { existsSync, lstatSync, realpathSync } from "node:fs";
 import { z } from "zod";
-import { watch } from "fs";
 import { EventEmitter } from "events";
+import { watch } from "fs";
 import { exec, spawn } from "child_process";
 import { promisify } from "util";
 import { parse } from "yaml";
@@ -220,14 +221,14 @@ var MarkdownParser = class {
 			if (currentOperation === "RENAMED") {
 				const fromMatch = line.match(/FROM:\s*`?###\s*Requirement:\s*(.+?)`?$/i);
 				const toMatch = line.match(/TO:\s*`?###\s*Requirement:\s*(.+?)`?$/i);
-				if (fromMatch) renameBuffer = {
-					...renameBuffer ?? {},
-					from: fromMatch[1].trim()
-				};
-				if (toMatch) renameBuffer = {
-					...renameBuffer ?? {},
-					to: toMatch[1].trim()
-				};
+				if (fromMatch) {
+					if (!renameBuffer) renameBuffer = {};
+					renameBuffer.from = fromMatch[1].trim();
+				}
+				if (toMatch) {
+					if (!renameBuffer) renameBuffer = {};
+					renameBuffer.to = toMatch[1].trim();
+				}
 				if (renameBuffer?.from && renameBuffer?.to) {
 					deltas.push({
 						spec: deltaSpec.specId,
@@ -312,86 +313,6 @@ var MarkdownParser = class {
 	}
 };
 
-//#endregion
-//#region src/validator.ts
-/**
-* Validator for OpenSpec documents
-*/
-var Validator = class {
-	/**
-	* Validate a spec document
-	*/
-	validateSpec(spec) {
-		const issues = [];
-		if (!spec.overview || spec.overview.trim().length === 0) issues.push({
-			severity: "ERROR",
-			message: "Spec must have a Purpose/Overview section",
-			path: "overview"
-		});
-		if (spec.requirements.length === 0) issues.push({
-			severity: "ERROR",
-			message: "Spec must have at least one requirement",
-			path: "requirements"
-		});
-		for (const req of spec.requirements) {
-			if (!req.text.includes("SHALL") && !req.text.includes("MUST")) issues.push({
-				severity: "WARNING",
-				message: `Requirement should contain "SHALL" or "MUST": ${req.id}`,
-				path: `requirements.${req.id}`
-			});
-			if (req.scenarios.length === 0) issues.push({
-				severity: "WARNING",
-				message: `Requirement should have at least one scenario: ${req.id}`,
-				path: `requirements.${req.id}.scenarios`
-			});
-			if (req.text.length > 1e3) issues.push({
-				severity: "WARNING",
-				message: `Requirement text is too long (max 1000 chars): ${req.id}`,
-				path: `requirements.${req.id}.text`
-			});
-		}
-		return {
-			valid: issues.filter((i) => i.severity === "ERROR").length === 0,
-			issues
-		};
-	}
-	/**
-	* Validate a change proposal
-	*/
-	validateChange(change) {
-		const issues = [];
-		if (!change.why || change.why.length < 50) issues.push({
-			severity: "ERROR",
-			message: "Change \"Why\" section must be at least 50 characters",
-			path: "why"
-		});
-		if (change.why && change.why.length > 500) issues.push({
-			severity: "WARNING",
-			message: "Change \"Why\" section should be under 500 characters",
-			path: "why"
-		});
-		if (!change.whatChanges || change.whatChanges.trim().length === 0) issues.push({
-			severity: "ERROR",
-			message: "Change must have a \"What Changes\" section",
-			path: "whatChanges"
-		});
-		if (change.deltas.length === 0) issues.push({
-			severity: "WARNING",
-			message: "Change should have at least one delta",
-			path: "deltas"
-		});
-		if (change.deltas.length > 50) issues.push({
-			severity: "WARNING",
-			message: "Change has too many deltas (max 50)",
-			path: "deltas"
-		});
-		return {
-			valid: issues.filter((i) => i.severity === "ERROR").length === 0,
-			issues
-		};
-	}
-};
-
 //#endregion
 //#region src/reactive-fs/reactive-state.ts
 /**
@@ -578,8 +499,10 @@ const DEFAULT_IGNORE = [
 	".git",
 	"**/.DS_Store"
 ];
-/** 健康检查间隔 (ms) - 3秒 */
-const HEALTH_CHECK_INTERVAL_MS = 3e3;
+/** 恢复重试间隔 (ms) */
+const RECOVERY_INTERVAL_MS = 3e3;
+/** 路径语义检查间隔 (ms) */
+const PATH_LIVENESS_INTERVAL_MS = 3e3;
 /**
 * 项目监听器
 *
@@ -602,17 +525,25 @@ var ProjectWatcher = class {
 	ignore;
 	initialized = false;
 	initPromise = null;
-	healthCheckTimer = null;
-	lastEventTime = 0;
-	healthCheckPending = false;
-	enableHealthCheck;
 	reinitializeTimer = null;
 	reinitializePending = false;
+	reinitializeReasonPending = null;
+	pathLivenessTimer = null;
+	projectDirFingerprint = null;
+	generation = 0;
+	reinitializeCount = 0;
+	lastReinitializeReason = null;
+	reinitializeReasonCounts = {
+		"drop-events": 0,
+		"watcher-error": 0,
+		"missing-project-dir": 0,
+		"project-dir-replaced": 0,
+		manual: 0
+	};
 	constructor(projectDir, options = {}) {
 		this.projectDir = getRealPath$1(projectDir);
 		this.debounceMs = options.debounceMs ?? DEBOUNCE_MS$1;
 		this.ignore = options.ignore ?? DEFAULT_IGNORE;
-		this.enableHealthCheck = options.enableHealthCheck ?? true;
 	}
 	/**
 	* 初始化 watcher
@@ -621,8 +552,11 @@ var ProjectWatcher = class {
 	async init() {
 		if (this.initialized) return;
 		if (this.initPromise) return this.initPromise;
-		this.initPromise = this.doInit();
-		await this.initPromise;
+		this.initPromise = this.doInit().catch((error) => {
+			this.initPromise = null;
+			throw error;
+		});
+		return this.initPromise;
 	}
 	async doInit() {
 		this.subscription = await (await import("@parcel/watcher")).subscribe(this.projectDir, (err, events) => {
@@ -633,43 +567,98 @@ var ProjectWatcher = class {
 			this.handleEvents(events);
 		}, { ignore: this.ignore });
 		this.initialized = true;
-		this.lastEventTime = Date.now();
-		if (this.enableHealthCheck) this.startHealthCheck();
+		this.generation += 1;
+		this.projectDirFingerprint = this.getProjectDirFingerprint();
+		this.startPathLivenessMonitor();
 	}
 	/**
 	* 处理 watcher 错误
-	* 对于 FSEvents dropped 错误，触发延迟重建
+	* 统一走错误驱动重建流程
 	*/
 	handleWatcherError(err) {
 		if ((err.message || String(err)).includes("Events were dropped")) {
 			if (!this.reinitializePending) {
 				console.warn("[ProjectWatcher] FSEvents dropped events, scheduling reinitialize...");
-				this.scheduleReinitialize();
+				this.scheduleReinitialize("drop-events");
 			}
 			return;
 		}
-		console.error("[ProjectWatcher] Error:", err);
+		console.error("[ProjectWatcher] Watcher error, scheduling reinitialize:", err);
+		this.scheduleReinitialize("watcher-error");
 	}
 	/**
 	* 延迟重建 watcher（防抖，避免频繁重建）
 	*/
-	scheduleReinitialize() {
+	scheduleReinitialize(reason) {
+		this.reinitializeReasonPending = reason;
 		if (this.reinitializePending) return;
 		this.reinitializePending = true;
 		if (this.reinitializeTimer) clearTimeout(this.reinitializeTimer);
 		this.reinitializeTimer = setTimeout(() => {
 			this.reinitializeTimer = null;
 			this.reinitializePending = false;
-			console.log("[ProjectWatcher] Reinitializing due to FSEvents error...");
-			this.reinitialize();
-		}, 1e3);
+			const pendingReason = this.reinitializeReasonPending ?? reason;
+			this.reinitializeReasonPending = null;
+			console.log(`[ProjectWatcher] Reinitializing (reason: ${pendingReason})...`);
+			this.reinitialize(pendingReason);
+		}, RECOVERY_INTERVAL_MS);
+		this.reinitializeTimer.unref();
+	}
+	/**
+	* 读取项目目录指纹（目录不存在时返回 null）
+	* 用于检测 path 对应实体是否被替换（inode/dev 漂移）
+	*/
+	getProjectDirFingerprint() {
+		try {
+			const stat$1 = lstatSync(this.projectDir);
+			return `${stat$1.dev}:${stat$1.ino}`;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* 启动路径语义监测（避免 watcher 绑定到已失效句柄）
+	*/
+	startPathLivenessMonitor() {
+		this.stopPathLivenessMonitor();
+		this.pathLivenessTimer = setInterval(() => {
+			this.checkPathLiveness();
+		}, PATH_LIVENESS_INTERVAL_MS);
+		this.pathLivenessTimer.unref();
+	}
+	/**
+	* 停止路径语义监测
+	*/
+	stopPathLivenessMonitor() {
+		if (this.pathLivenessTimer) {
+			clearInterval(this.pathLivenessTimer);
+			this.pathLivenessTimer = null;
+		}
+	}
+	/**
+	* 只读检查 projectDir 是否仍指向初始化时的目录实体
+	*/
+	checkPathLiveness() {
+		if (!this.initialized || this.reinitializePending) return;
+		const current = this.getProjectDirFingerprint();
+		if (current === null) {
+			console.warn("[ProjectWatcher] Project directory missing, scheduling reinitialize...");
+			this.scheduleReinitialize("missing-project-dir");
+			return;
+		}
+		if (this.projectDirFingerprint === null) {
+			this.projectDirFingerprint = current;
+			return;
+		}
+		if (current !== this.projectDirFingerprint) {
+			console.warn("[ProjectWatcher] Project directory replaced, scheduling reinitialize...");
+			this.scheduleReinitialize("project-dir-replaced");
+		}
 	}
 	/**
 	* 处理原始事件
 	*/
 	handleEvents(events) {
-		this.lastEventTime = Date.now();
-		this.healthCheckPending = false;
 		const watchEvents = events.map((e) => ({
 			type: e.type,
 			path: e.path
@@ -757,60 +746,29 @@ var ProjectWatcher = class {
 		return this.initialized;
 	}
 	/**
-	* 启动健康检查定时器
-	*/
-	startHealthCheck() {
-		this.stopHealthCheck();
-		this.healthCheckTimer = setInterval(() => {
-			this.performHealthCheck();
-		}, HEALTH_CHECK_INTERVAL_MS);
-		this.healthCheckTimer.unref();
-	}
-	/**
-	* 停止健康检查定时器
+	* 获取 watcher 运行时状态
 	*/
-	stopHealthCheck() {
-		if (this.healthCheckTimer) {
-			clearInterval(this.healthCheckTimer);
-			this.healthCheckTimer = null;
-		}
-		this.healthCheckPending = false;
-	}
-	/**
-	* 执行健康检查
-	*
-	* 工作流程：
-	* 1. 如果最近有事件，无需检查
-	* 2. 如果上次探测还在等待中，说明 watcher 可能失效，尝试重建
-	* 3. 否则，创建临时文件触发事件，等待下次检查验证
-	*/
-	async performHealthCheck() {
-		if (Date.now() - this.lastEventTime < HEALTH_CHECK_INTERVAL_MS) {
-			this.healthCheckPending = false;
-			return;
-		}
-		if (this.healthCheckPending) {
-			console.warn("[ProjectWatcher] Health check failed, watcher appears stale. Reinitializing...");
-			await this.reinitialize();
-			return;
-		}
-		this.healthCheckPending = true;
-		this.sendProbe();
+	get runtimeStatus() {
+		return {
+			generation: this.generation,
+			reinitializeCount: this.reinitializeCount,
+			lastReinitializeReason: this.lastReinitializeReason,
+			reinitializeReasonCounts: { ...this.reinitializeReasonCounts }
+		};
 	}
 	/**
-	* 发送探测：通过 utimesSync 修改项目目录的时间戳来触发 watcher 事件
+	* 记录重建统计
 	*/
-	sendProbe() {
-		try {
-			const now = /* @__PURE__ */ new Date();
-			utimesSync(this.projectDir, now, now);
-		} catch {}
+	markReinitialized(reason) {
+		this.reinitializeCount += 1;
+		this.lastReinitializeReason = reason;
+		this.reinitializeReasonCounts[reason] += 1;
 	}
 	/**
 	* 重新初始化 watcher
 	*/
-	async reinitialize() {
-		this.stopHealthCheck();
+	async reinitialize(reason) {
+		this.stopPathLivenessMonitor();
 		if (this.subscription) {
 			try {
 				await this.subscription.unsubscribe();
@@ -819,38 +777,50 @@ var ProjectWatcher = class {
 		}
 		this.initialized = false;
 		this.initPromise = null;
-		this.healthCheckPending = false;
+		this.projectDirFingerprint = null;
 		if (!existsSync(this.projectDir)) {
 			console.warn("[ProjectWatcher] Project directory does not exist, waiting for it to be created...");
-			this.waitForProjectDir();
+			this.waitForProjectDir("missing-project-dir");
 			return;
 		}
 		try {
 			await this.init();
+			this.markReinitialized(reason);
 			console.log("[ProjectWatcher] Reinitialized successfully");
 		} catch (err) {
 			console.error("[ProjectWatcher] Failed to reinitialize:", err);
-			setTimeout(() => this.reinitialize(), HEALTH_CHECK_INTERVAL_MS);
+			this.scheduleReinitialize(reason);
 		}
 	}
 	/**
 	* 等待项目目录被创建
 	*/
-	waitForProjectDir() {
-		const checkInterval = setInterval(() => {
-			if (existsSync(this.projectDir)) {
-				clearInterval(checkInterval);
-				console.log("[ProjectWatcher] Project directory created, reinitializing...");
-				this.reinitialize();
+	waitForProjectDir(reason) {
+		this.reinitializeReasonPending = reason;
+		this.reinitializePending = true;
+		if (this.reinitializeTimer) {
+			clearTimeout(this.reinitializeTimer);
+			this.reinitializeTimer = null;
+		}
+		this.reinitializeTimer = setTimeout(() => {
+			this.reinitializeTimer = null;
+			this.reinitializePending = false;
+			if (!existsSync(this.projectDir)) {
+				this.waitForProjectDir(reason);
+				return;
 			}
-		}, HEALTH_CHECK_INTERVAL_MS);
-		checkInterval.unref();
+			const pendingReason = this.reinitializeReasonPending ?? reason;
+			this.reinitializeReasonPending = null;
+			console.log("[ProjectWatcher] Project directory created, reinitializing...");
+			this.reinitialize(pendingReason);
+		}, RECOVERY_INTERVAL_MS);
+		this.reinitializeTimer.unref();
 	}
 	/**
 	* 关闭 watcher
 	*/
 	async close() {
-		this.stopHealthCheck();
+		this.stopPathLivenessMonitor();
 		if (this.debounceTimer) {
 			clearTimeout(this.debounceTimer);
 			this.debounceTimer = null;
@@ -860,6 +830,7 @@ var ProjectWatcher = class {
 			this.reinitializeTimer = null;
 		}
 		this.reinitializePending = false;
+		this.reinitializeReasonPending = null;
 		if (this.subscription) {
 			await this.subscription.unsubscribe();
 			this.subscription = null;
@@ -868,6 +839,7 @@ var ProjectWatcher = class {
 		this.pendingEvents = [];
 		this.initialized = false;
 		this.initPromise = null;
+		this.projectDirFingerprint = null;
 	}
 };
 /**
@@ -1032,6 +1004,22 @@ function isWatcherPoolInitialized() {
 function getWatchedProjectDir() {
 	return globalProjectDir;
 }
+/**
+* 获取 watcher 运行时状态
+*/
+function getWatcherRuntimeStatus() {
+	if (!globalProjectWatcher) return null;
+	const runtime = globalProjectWatcher.runtimeStatus;
+	return {
+		projectDir: globalProjectDir,
+		initialized: globalProjectWatcher.isInitialized,
+		subscriptionCount: globalProjectWatcher.subscriptionCount,
+		generation: runtime.generation,
+		reinitializeCount: runtime.reinitializeCount,
+		lastReinitializeReason: runtime.lastReinitializeReason,
+		reinitializeReasonCounts: runtime.reinitializeReasonCounts
+	};
+}
 
 //#endregion
 //#region src/reactive-fs/reactive-fs.ts
@@ -1229,6 +1217,86 @@ function getCacheSize() {
 	return stateCache$1.size;
 }
 
+//#endregion
+//#region src/validator.ts
+/**
+* Validator for OpenSpec documents
+*/
+var Validator = class {
+	/**
+	* Validate a spec document
+	*/
+	validateSpec(spec) {
+		const issues = [];
+		if (!spec.overview || spec.overview.trim().length === 0) issues.push({
+			severity: "ERROR",
+			message: "Spec must have a Purpose/Overview section",
+			path: "overview"
+		});
+		if (spec.requirements.length === 0) issues.push({
+			severity: "ERROR",
+			message: "Spec must have at least one requirement",
+			path: "requirements"
+		});
+		for (const req of spec.requirements) {
+			if (!req.text.includes("SHALL") && !req.text.includes("MUST")) issues.push({
+				severity: "WARNING",
+				message: `Requirement should contain "SHALL" or "MUST": ${req.id}`,
+				path: `requirements.${req.id}`
+			});
+			if (req.scenarios.length === 0) issues.push({
+				severity: "WARNING",
+				message: `Requirement should have at least one scenario: ${req.id}`,
+				path: `requirements.${req.id}.scenarios`
+			});
+			if (req.text.length > 1e3) issues.push({
+				severity: "WARNING",
+				message: `Requirement text is too long (max 1000 chars): ${req.id}`,
+				path: `requirements.${req.id}.text`
+			});
+		}
+		return {
+			valid: issues.filter((i) => i.severity === "ERROR").length === 0,
+			issues
+		};
+	}
+	/**
+	* Validate a change proposal
+	*/
+	validateChange(change) {
+		const issues = [];
+		if (!change.why || change.why.length < 50) issues.push({
+			severity: "ERROR",
+			message: "Change \"Why\" section must be at least 50 characters",
+			path: "why"
+		});
+		if (change.why && change.why.length > 500) issues.push({
+			severity: "WARNING",
+			message: "Change \"Why\" section should be under 500 characters",
+			path: "why"
+		});
+		if (!change.whatChanges || change.whatChanges.trim().length === 0) issues.push({
+			severity: "ERROR",
+			message: "Change must have a \"What Changes\" section",
+			path: "whatChanges"
+		});
+		if (change.deltas.length === 0) issues.push({
+			severity: "WARNING",
+			message: "Change should have at least one delta",
+			path: "deltas"
+		});
+		if (change.deltas.length > 50) issues.push({
+			severity: "WARNING",
+			message: "Change has too many deltas (max 50)",
+			path: "deltas"
+		});
+		return {
+			valid: issues.filter((i) => i.severity === "ERROR").length === 0,
+			issues
+		};
+	}
+};
+
 //#endregion
 //#region src/adapter.ts
 /**
@@ -1890,6 +1958,11 @@ const CURSOR_STYLE_VALUES = [
 	"underline",
 	"bar"
 ];
+const TERMINAL_RENDERER_ENGINE_VALUES = ["xterm", "ghostty"];
+const TerminalRendererEngineSchema = z.enum(TERMINAL_RENDERER_ENGINE_VALUES);
+function isTerminalRendererEngine(value) {
+	return TERMINAL_RENDERER_ENGINE_VALUES.includes(value);
+}
 const BASE_PACKAGE_MANAGER_RUNNERS = [
 	{
 		id: "npx",
@@ -2227,8 +2300,10 @@ const TerminalConfigSchema = z.object({
 	fontFamily: z.string().default(""),
 	cursorBlink: z.boolean().default(true),
 	cursorStyle: z.enum(CURSOR_STYLE_VALUES).default("block"),
-	scrollback: z.number().min(0).max(1e5).default(1e3)
+	scrollback: z.number().min(0).max(1e5).default(1e3),
+	rendererEngine: z.string().default("xterm")
 });
+const DashboardConfigSchema = z.object({ trendPointLimit: z.number().int().min(20).max(500).default(100) });
 /**
 * OpenSpecUI 配置 Schema
 *
@@ -2240,13 +2315,15 @@ const OpenSpecUIConfigSchema = z.object({
 		args: z.array(z.string()).optional()
 	}).default({}),
 	theme: z.enum(THEME_VALUES).default("system"),
-	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({}))
+	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
+	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({}))
 });
 /** 默认配置（静态，用于测试和类型） */
 const DEFAULT_CONFIG = {
 	cli: {},
 	theme: "system",
-	terminal: TerminalConfigSchema.parse({})
+	terminal: TerminalConfigSchema.parse({}),
+	dashboard: DashboardConfigSchema.parse({})
 };
 /**
 * 配置管理器
@@ -2312,6 +2389,10 @@ var ConfigManager = class {
 			terminal: {
 				...current.terminal,
 				...config.terminal
+			},
+			dashboard: {
+				...current.dashboard,
+				...config.dashboard
 			}
 		};
 		const serialized = JSON.stringify(merged, null, 2);
@@ -3048,6 +3129,17 @@ async function isToolConfigured(projectDir, toolId) {
 	return (await getConfiguredTools(projectDir)).includes(toolId);
 }
 
+//#endregion
+//#region src/dashboard-types.ts
+const DASHBOARD_METRIC_KEYS = [
+	"specifications",
+	"requirements",
+	"activeChanges",
+	"inProgressChanges",
+	"completedChanges",
+	"taskCompletionPercent"
+];
+
 //#endregion
 //#region src/opsx-types.ts
 /** Check if an outputPath contains glob pattern characters */
@@ -3135,17 +3227,20 @@ const SchemaResolutionSchema = z.object({
 		"package"
 	]),
 	path: z.string(),
+	displayPath: z.string().optional(),
 	shadows: z.array(z.object({
 		source: z.enum([
 			"project",
 			"user",
 			"package"
 		]),
-		path: z.string()
+		path: z.string(),
+		displayPath: z.string().optional()
 	}))
 });
 const TemplatesSchema = z.record(z.object({
 	path: z.string(),
+	displayPath: z.string().optional(),
 	source: z.enum([
 		"project",
 		"user",
@@ -3189,6 +3284,12 @@ function parseCliJson(raw, schema, label) {
 function toRelativePath(root, absolutePath) {
 	return relative(root, absolutePath).split(sep).join("/");
 }
+function isAbsoluteFsPath(path) {
+	return path.startsWith("/") || /^[A-Za-z]:\//.test(path);
+}
+function toAbsoluteProjectPath(projectDir, path) {
+	return isAbsoluteFsPath(path.replace(/\\/g, "/")) ? path : resolve(projectDir, path);
+}
 async function readEntriesUnderRoot(root) {
 	if (!(await reactiveStat(root))?.isDirectory) return [];
 	const collectEntries = async (dir) => {
@@ -3627,7 +3728,21 @@ var OpsxKernel = class {
 		await touchOpsxProjectDeps(this.projectDir);
 		const result = await this.cliExecutor.schemaWhich(name);
 		if (!result.success) throw new Error(result.stderr || `openspec schema which failed (exit ${result.exitCode ?? "null"})`);
-		return parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+		const parsed = parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+		return {
+			...parsed,
+			displayPath: toOpsxDisplayPath(parsed.path, {
+				source: parsed.source,
+				projectDir: this.projectDir
+			}),
+			shadows: parsed.shadows.map((shadow) => ({
+				...shadow,
+				displayPath: toOpsxDisplayPath(shadow.path, {
+					source: shadow.source,
+					projectDir: this.projectDir
+				})
+			}))
+		};
 	}
 	async fetchSchemaDetail(name) {
 		await touchOpsxProjectDeps(this.projectDir);
@@ -3651,7 +3766,15 @@ var OpsxKernel = class {
 		await touchOpsxProjectDeps(this.projectDir);
 		const result = await this.cliExecutor.templates(schema);
 		if (!result.success) throw new Error(result.stderr || `openspec templates failed (exit ${result.exitCode ?? "null"})`);
-		return parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
+		const templates = parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
+		return Object.fromEntries(Object.entries(templates).map(([artifactId, info]) => [artifactId, {
+			...info,
+			path: toAbsoluteProjectPath(this.projectDir, info.path),
+			displayPath: toOpsxDisplayPath(info.path, {
+				source: info.source,
+				projectDir: this.projectDir
+			})
+		}]));
 	}
 	async fetchTemplateContents(schema) {
 		await this.ensureTemplates(schema);
@@ -3660,6 +3783,10 @@ var OpsxKernel = class {
 			return [artifactId, {
 				content: await reactiveReadFile(info.path),
 				path: info.path,
+				displayPath: info.displayPath ?? toOpsxDisplayPath(info.path, {
+					source: info.source,
+					projectDir: this.projectDir
+				}),
 				source: info.source
 			}];
 		}));
@@ -3908,4 +4035,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, ConfigManager, DEFAULT_CONFIG, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, MarkdownParser, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TaskSchema, TemplatesSchema, TerminalConfigSchema, Validator, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, initWatcherPool, isGlobPattern, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };
+export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, MarkdownParser, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli, toOpsxDisplayPath };