@overdeck/desktop 0.45.21 → 0.45.23

package/server/{io-BiM-7Zsx.js → io-B3_AHDfr.js}

@@ -1,114 +1,69 @@
 import { n as __esmMin } from "./rolldown-runtime-DNCzzKnI.js";
-import { At as init_record, En as findProjectByPathSync, Ft as readIssueRecordSync, Lt as resolveProjectForIssue, Nt as readIssueRecord, Or as init_errors, _n as resolveStateReadHomeSync, an as init_auto_commit, gn as init_state_read_home, in as flushAutoCommits, kt as getProjectConfigFromWorkspacePath, nn as deriveProjectRoot, on as queueAutoCommit, vr as FsError, zn as init_projects } from "./config-yaml-Ciyp2mYe.js";
-import { a as PAN_DIRNAME, f as asPanSpecDocument, l as PAN_SPECS_DIRNAME, m as isPanSpecStatus, o as PAN_DRAFTS_DIRNAME, p as init_types$1, r as PAN_CONTINUES_DIRNAME, u as PAN_SPEC_FILENAME } from "./types-DqeBMmJN.js";
+import { Bt as deriveProjectRoot, Dt as getProjectConfigFromWorkspacePath, Ft as resolveProjectForIssue, Ht as flushAutoCommits, Nt as readIssueRecordSync, Ot as init_record, Tn as init_projects, Ut as init_auto_commit, Wt as queueAutoCommit, fn as findProjectByPathSync, ir as FsError, jt as readIssueRecord, mr as init_errors, nn as init_state_read_home, rn as resolveStateReadHomeSync } from "./config-yaml-DvyMuOle.js";
+import { a as PAN_DIRNAME, c as PAN_SESSIONS_FILENAME, d as WORKSPACE_RUNTIME_DIRNAME, f as asPanSpecDocument, i as PAN_CONTINUE_FILENAME, l as PAN_SPECS_DIRNAME, m as isPanSpecStatus, n as PAN_CONTEXT_FILENAME, o as PAN_DRAFTS_DIRNAME, p as init_types$1, r as PAN_CONTINUES_DIRNAME, s as PAN_FEEDBACK_DIRNAME, t as LEGACY_WORKSPACE_RUNTIME_DIRNAME, u as PAN_SPEC_FILENAME } from "./types-hraoaQIp.js";
+import { a as generateXBriefFilename, c as parseXBriefFilename, l as resolveXBriefDir, n as LEGACY_VBRIEF_LIFECYCLE_DIRS, o as init_lifecycle, u as slugify } from "./lifecycle-DfeyBDwA.js";
 import { Data, Effect, FileSystem } from "effect";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
 import { basename, join, resolve } from "path";
+import { existsSync as existsSync$1 } from "node:fs";
 import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
 import { readFile, readdir } from "fs/promises";
-//#region ../../lib/vbrief/lifecycle.ts
-/**
-* vBRIEF Lifecycle Foundation
-*
-* Filesystem-as-state lifecycle model for scope vBRIEFs. Each registered
-* project gets a `./vbrief/` directory at its repo root with four lifecycle
-* subdirectories that act as the source of truth for plan status:
-*
-*   ./vbrief/proposed/   — planning complete, awaiting approval
-*   ./vbrief/active/     — agent is working on it
-*   ./vbrief/completed/  — merged/closed, immutable archive
-*   ./vbrief/cancelled/  — abandoned, immutable archive
-*
-* Filenames are issue-keyed: `YYYY-MM-DD-<ISSUE-ID>-<slug>.vbrief.json` where
-* the date is the immutable creation date. Issue ID gives Overdeck ergonomics
-* (one vBRIEF per issue) and slug gives human readability.
-*/
-/**
-* Slugify an arbitrary string for use in a vBRIEF filename. Lowercases,
-* replaces non-alphanumeric runs with single dashes, trims leading/trailing
-* dashes, and collapses repeats.
-*/
-function slugify(input) {
-	return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-") || "plan";
+//#region ../../lib/pan-dir/continue.ts
+function workspacePanPaths(workspacePath) {
+	const panDir = join(workspacePath, WORKSPACE_RUNTIME_DIRNAME);
+	return {
+		panDir,
+		specPath: join(panDir, PAN_SPEC_FILENAME),
+		continuePath: join(panDir, PAN_CONTINUE_FILENAME),
+		sessionsPath: join(panDir, PAN_SESSIONS_FILENAME),
+		feedbackDir: join(panDir, PAN_FEEDBACK_DIRNAME),
+		contextPath: join(panDir, PAN_CONTEXT_FILENAME)
+	};
 }
-/**
-* Format a JS Date (or ISO string / YYYY-MM-DD) as YYYY-MM-DD in UTC.
-*/
-function formatDate(value) {
-	const d = typeof value === "string" ? new Date(value) : value;
-	if (Number.isNaN(d.getTime())) throw new Error(`Invalid date: ${String(value)}`);
-	return `${d.getUTCFullYear().toString().padStart(4, "0")}-${(d.getUTCMonth() + 1).toString().padStart(2, "0")}-${d.getUTCDate().toString().padStart(2, "0")}`;
+function getWorkspacePanPaths(workspacePath) {
+	return workspacePanPaths(workspacePath);
 }
-/**
-* Generate the canonical vBRIEF filename for an issue.
-*
-* Format: `YYYY-MM-DD-<ISSUE-ID>-<slug>.vbrief.json`
-* Example: `2026-05-03-PAN-946-vbrief-lifecycle.vbrief.json`
-*
-* @param issueId - Issue identifier in the form `PREFIX-NUMBER` (e.g. `PAN-946`).
-*                  Normalized to uppercase in the filename — issue IDs are
-*                  uppercase by convention, and case-preservation let a
-*                  lowercased caller produce a duplicate, case-colliding
-*                  spec file (PAN-1050).
-* @param slug    - Free-form slug (will be normalized via slugify).
-* @param createdDate - Date or ISO string used for the YYYY-MM-DD prefix.
-*                      Defaults to "now". Always interpreted in UTC so filenames
-*                      are stable across timezones.
-*/
-function generateVBriefFilename(issueId, slug, createdDate = /* @__PURE__ */ new Date()) {
-	if (!/^[A-Za-z][A-Za-z0-9]*-\d+$/.test(issueId)) throw new Error(`Invalid issue ID for vBRIEF filename: ${issueId} (expected e.g. PAN-946)`);
-	const canonicalIssueId = issueId.toUpperCase();
-	return `${formatDate(createdDate)}-${canonicalIssueId}-${slugify(slug)}.vbrief.json`;
-}
-/**
-* Parse a canonical vBRIEF filename back into its parts. Returns null if the
-* filename doesn't match the convention so callers can ignore stray files.
-*/
-function parseVBriefFilename(filename) {
-	const match = filename.match(FILENAME_RE);
-	if (!match) return null;
+function getLegacyWorkspacePanPaths(workspacePath) {
+	const panDir = join(workspacePath, LEGACY_WORKSPACE_RUNTIME_DIRNAME);
 	return {
-		date: match[1],
-		issueId: match[2],
-		slug: match[3]
+		panDir,
+		specPath: join(panDir, PAN_SPEC_FILENAME),
+		continuePath: join(panDir, PAN_CONTINUE_FILENAME),
+		sessionsPath: join(panDir, PAN_SESSIONS_FILENAME),
+		feedbackDir: join(panDir, PAN_FEEDBACK_DIRNAME),
+		contextPath: join(panDir, PAN_CONTEXT_FILENAME)
 	};
 }
-/**
-* Resolve the absolute path of a specific lifecycle directory under a project's
-* vBRIEF root. Pure path math — does not check existence or create dirs.
-*
-* @param vbriefDirname - Override the default "vbrief" dirname (from projects.yaml `vbrief_dir`).
-*/
-function resolveVBriefDir(projectRoot, lifecycleDir, vbriefDirname) {
-	return join(projectRoot, vbriefDirname || "vbrief", lifecycleDir);
+/** Resolve workspace runtime reads to `.overdeck/`, then legacy `.pan/`. */
+function getReadableWorkspacePanPaths(workspacePath) {
+	const canonical = getWorkspacePanPaths(workspacePath);
+	return existsSync$1(canonical.panDir) ? canonical : getLegacyWorkspacePanPaths(workspacePath);
 }
-/**
-* Ensure the vBRIEF lifecycle directories exist under the given project root.
-* Returns the absolute path to the vBRIEF root. Idempotent.
-*
-* @param vbriefDirname - Override the default "vbrief" dirname (from projects.yaml `vbrief_dir`).
-*/
-function ensureVBriefDirsSync(projectRoot, vbriefDirname) {
-	const root = join(projectRoot, vbriefDirname || "vbrief");
-	mkdirSync(root, { recursive: true });
-	for (const dir of VBRIEF_LIFECYCLE_DIRS) mkdirSync(join(root, dir), { recursive: true });
-	return root;
-}
-var VBRIEF_LIFECYCLE_DIRS, FILENAME_RE;
-var init_lifecycle = __esmMin((() => {
+function ensureWorkspacePanDir(workspacePath) {
+	return Effect.gen(function* () {
+		const fs = yield* FileSystem.FileSystem;
+		const paths = workspacePanPaths(workspacePath);
+		yield* fs.makeDirectory(paths.panDir, { recursive: true }).pipe(Effect.mapError((cause) => new FsError({
+			path: paths.panDir,
+			operation: "makeDirectory",
+			cause
+		})));
+		yield* fs.makeDirectory(paths.feedbackDir, { recursive: true }).pipe(Effect.mapError((cause) => new FsError({
+			path: paths.feedbackDir,
+			operation: "makeDirectory",
+			cause
+		})));
+		return paths;
+	}).pipe(Effect.provide(NodeFileSystem.layer));
+}
+var init_continue = __esmMin((() => {
 	init_errors();
-	VBRIEF_LIFECYCLE_DIRS = [
-		"proposed",
-		"active",
-		"completed",
-		"cancelled"
-	];
-	FILENAME_RE = /^(\d{4}-\d{2}-\d{2})-([A-Za-z][A-Za-z0-9]*-\d+)-([a-z0-9-]+)\.vbrief\.json$/;
+	init_types$1();
 }));
 //#endregion
-//#region ../../lib/vbrief/vbrief-index.ts
+//#region ../../lib/xbrief/xbrief-index.ts
 /**
-* vBRIEF Index — async, cached issue→vBRIEF lookups for server hot paths.
+* xBRIEF Index — async, cached issue→xBRIEF lookups for server hot paths.
 *
 * PAN-967 Phase 2 makes `.pan/specs/` the canonical spec store. During the
 * migration window, legacy `vbrief/<lifecycle>/` directories remain as fallback
@@ -124,7 +79,7 @@ async function scanPanSpecs(projectRoot) {
 		return [];
 	}
 	return (await Promise.all(names.map(async (name) => {
-		const parts = parseVBriefFilename(name);
+		const parts = parseXBriefFilename(name);
 		if (!parts) return null;
 		const path = join(specsDir, name);
 		try {
@@ -152,8 +107,8 @@ async function buildProjectIndex(projectRoot) {
 		entries.push(entry);
 		if (!byIssue.has(entry.issueId)) byIssue.set(entry.issueId, entry);
 	}
-	for (const lifecycleDir of VBRIEF_LIFECYCLE_DIRS) {
-		const dirPath = resolveVBriefDir(projectRoot, lifecycleDir);
+	for (const lifecycleDir of LEGACY_VBRIEF_LIFECYCLE_DIRS) {
+		const dirPath = resolveXBriefDir(projectRoot, lifecycleDir);
 		if (!existsSync(dirPath)) continue;
 		let names;
 		try {
@@ -162,7 +117,7 @@ async function buildProjectIndex(projectRoot) {
 			continue;
 		}
 		for (const name of names) {
-			const parts = parseVBriefFilename(name);
+			const parts = parseXBriefFilename(name);
 			if (!parts || byIssue.has(parts.issueId)) continue;
 			const entry = {
 				path: join(dirPath, name),
@@ -189,29 +144,29 @@ async function getOrBuildIndex(projectRoot) {
 	projectIndexCache.set(projectRoot, fresh);
 	return fresh;
 }
-function invalidateVBriefIndex(projectRoot) {
+function invalidateXBriefIndex(projectRoot) {
 	projectIndexCache.delete(projectRoot);
 }
-var CACHE_TTL_MS, projectIndexCache, findVBriefByIssue, readVBriefDocument;
-var init_vbrief_index = __esmMin((() => {
+var CACHE_TTL_MS, projectIndexCache, findXBriefByIssue, readXBriefDocument;
+var init_xbrief_index = __esmMin((() => {
 	init_lifecycle();
 	init_io();
 	init_errors();
 	init_types$1();
 	CACHE_TTL_MS = 5e3;
 	projectIndexCache = /* @__PURE__ */ new Map();
-	findVBriefByIssue = (projectRoot, issueId) => Effect.tryPromise({
+	findXBriefByIssue = (projectRoot, issueId) => Effect.tryPromise({
 		try: async () => {
 			const upper = issueId.toUpperCase();
 			return (await getOrBuildIndex(projectRoot)).byIssue.get(upper) ?? null;
 		},
 		catch: (cause) => new FsError({
 			path: projectRoot,
-			operation: "findVBriefByIssue",
+			operation: "findXBriefByIssue",
 			cause
 		})
 	});
-	readVBriefDocument = (path) => Effect.gen(function* () {
+	readXBriefDocument = (path) => Effect.gen(function* () {
 		const raw = yield* Effect.tryPromise({
 			try: () => readFile(path, "utf-8"),
 			catch: (cause) => new FsError({
@@ -220,20 +175,20 @@ var init_vbrief_index = __esmMin((() => {
 				cause
 			})
 		});
-		if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) return yield* Effect.fail(new VBriefMergeConflictTaggedError({ planPath: path }));
+		if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) return yield* Effect.fail(new XBriefMergeConflictTaggedError({ planPath: path }));
 		let parsed;
 		try {
-			parsed = normalizeVBriefEnvelope(JSON.parse(raw));
+			parsed = normalizeXBriefEnvelope(JSON.parse(raw));
 		} catch (cause) {
-			return yield* Effect.fail(new VBriefInvalidFormatError({
+			return yield* Effect.fail(new XBriefInvalidFormatError({
 				planPath: path,
 				reason: `invalid JSON: ${cause.message}`
 			}));
 		}
 		const obj = parsed;
-		if (!obj || !obj.vBRIEFInfo || !obj.plan) return yield* Effect.fail(new VBriefInvalidFormatError({
+		if (!obj || !obj.xBRIEFInfo || !obj.plan) return yield* Effect.fail(new XBriefInvalidFormatError({
 			planPath: path,
-			reason: `missing 'vBRIEFInfo' or 'xBRIEFInfo' and/or 'plan' top-level keys`
+			reason: `missing 'xBRIEFInfo' or 'vBRIEFInfo' and/or 'plan' top-level keys`
 		}));
 		return obj;
 	});
@@ -273,7 +228,7 @@ function ensurePanDirs(projectRoot) {
 		return paths;
 	}).pipe(Effect.provide(NodeFileSystem.layer));
 }
-function mapVBriefPlanStatusToPanSpec(status) {
+function mapXBriefPlanStatusToPanSpec(status) {
 	if (isPanSpecStatus(status)) return status;
 	if (typeof status !== "string") return null;
 	switch (status) {
@@ -286,10 +241,10 @@ function mapVBriefPlanStatusToPanSpec(status) {
 	}
 }
 function parsePanSpecDocumentFromString(raw, path) {
-	if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) throw new VBriefMergeConflictError(path);
+	if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) throw new XBriefMergeConflictError(path);
 	let parsed;
 	try {
-		parsed = normalizeVBriefEnvelope(JSON.parse(raw));
+		parsed = normalizeXBriefEnvelope(JSON.parse(raw));
 	} catch (error) {
 		throw new Error(`Invalid JSON in pan spec ${path}: ${error.message}`);
 	}
@@ -297,11 +252,15 @@ function parsePanSpecDocumentFromString(raw, path) {
 	const doc = parsed;
 	if (!isPanSpecStatus(doc.status)) {
 		const plan = doc.plan;
-		const mapped = mapVBriefPlanStatusToPanSpec(plan?.status);
+		const mapped = mapXBriefPlanStatusToPanSpec(plan?.status);
 		if (mapped) doc.status = mapped;
 		else throw new Error(`Invalid pan spec format in ${path}: missing valid root status`);
 	}
-	if (!doc.vBRIEFInfo || !doc.plan) throw new Error(`Invalid vBRIEF format in ${path}: missing 'vBRIEFInfo' or 'xBRIEFInfo' and/or 'plan' top-level keys. vBRIEF/xBRIEF v0.5-v0.8 requires { "vBRIEFInfo" or "xBRIEFInfo": { "version": "0.5" through "0.8" }, "plan": { ... } }. See docs/VBRIEF.md for the correct format.`);
+	if (!doc.xBRIEFInfo && !doc.vBRIEFInfo || !doc.plan) throw new Error(`Invalid xBRIEF format in ${path}: missing 'xBRIEFInfo' or legacy 'vBRIEFInfo' and/or 'plan' top-level keys. xBRIEF v0.5-v0.8 requires { "xBRIEFInfo" or legacy "vBRIEFInfo": { "version": "0.5" through "0.8" }, "plan": { ... } }. See docs/XBRIEF.md for the correct format.`);
+	if (!doc.xBRIEFInfo && doc.vBRIEFInfo) {
+		doc.xBRIEFInfo = doc.vBRIEFInfo;
+		delete doc.vBRIEFInfo;
+	}
 	return doc;
 }
 function readSpec(path) {
@@ -330,7 +289,7 @@ function writeSpec(path, doc) {
 		}));
 		const fs = yield* FileSystem.FileSystem;
 		const tmp = `${path}.tmp`;
-		yield* fs.writeFileString(tmp, serializeVBriefDocument(doc)).pipe(Effect.mapError((cause) => new FsError({
+		yield* fs.writeFileString(tmp, serializeXBriefDocument(doc)).pipe(Effect.mapError((cause) => new FsError({
 			path: tmp,
 			operation: "writeFileString",
 			cause
@@ -353,7 +312,7 @@ function writeSpec(path, doc) {
 }
 function entryFromFile(specsDir, filename) {
 	return Effect.gen(function* () {
-		const parts = parseVBriefFilename(filename);
+		const parts = parseXBriefFilename(filename);
 		if (!parts) return null;
 		const path = join(specsDir, filename);
 		const document = yield* readSpec(path).pipe(Effect.catch((err) => {
@@ -402,7 +361,9 @@ function findSpecByIssue(projectRoot, issueId) {
 			cause
 		})));
 		const upperIssueId = issueId.toUpperCase();
-		const matching = filenames.filter((filename) => parseVBriefFilename(filename)?.issueId.toUpperCase() === upperIssueId).sort((a, b) => a.localeCompare(b));
+		const matching = filenames.filter((filename) => parseXBriefFilename(filename)?.issueId.toUpperCase() === upperIssueId).sort((a, b) => {
+			return Number(!a.endsWith(".xbrief.json")) - Number(!b.endsWith(".xbrief.json")) || a.localeCompare(b);
+		});
 		for (const filename of matching) {
 			const entry = yield* entryFromFile(specsDir, filename);
 			if (entry) return entry;
@@ -414,7 +375,7 @@ function writeSpecForIssue(projectRoot, doc, status, filename) {
 	return Effect.gen(function* () {
 		const paths = yield* ensurePanDirs(projectRoot);
 		const specDocument = asPanSpecDocument(doc, status);
-		const nextFilename = filename ?? generateVBriefFilename(doc.plan.id, doc.plan.title);
+		const nextFilename = filename ?? generateXBriefFilename(doc.plan.id, doc.plan.title);
 		const path = join(paths.specsDir, nextFilename);
 		yield* writeSpec(path, specDocument);
 		queueAutoCommit({
@@ -428,13 +389,13 @@ function writeSpecForIssue(projectRoot, doc, status, filename) {
 			operation: "pushSpec",
 			cause: new Error(flushed.reason ?? "spec commit was not pushed")
 		}));
-		invalidateVBriefIndex(projectRoot);
+		invalidateXBriefIndex(projectRoot);
 		return {
 			path,
 			filename: nextFilename,
 			issueId: doc.plan.id,
-			slug: parseVBriefFilename(nextFilename)?.slug ?? slugify(doc.plan.title),
-			date: parseVBriefFilename(nextFilename)?.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+			slug: parseXBriefFilename(nextFilename)?.slug ?? slugify(doc.plan.title),
+			date: parseXBriefFilename(nextFilename)?.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
 			status,
 			document: specDocument
 		};
@@ -464,7 +425,7 @@ function writeSpecDocument(projectRoot, path, doc) {
 			operation: "pushSpec",
 			cause: new Error(flushed.reason ?? "spec commit was not pushed")
 		}));
-		invalidateVBriefIndex(projectRoot);
+		invalidateXBriefIndex(projectRoot);
 	});
 }
 var init_specs = __esmMin((() => {
@@ -473,18 +434,18 @@ var init_specs = __esmMin((() => {
 	init_state_read_home();
 	init_io();
 	init_lifecycle();
-	init_vbrief_index();
+	init_xbrief_index();
 	init_auto_commit();
 	init_types$1();
 }));
 //#endregion
-//#region ../../lib/vbrief/types.ts
+//#region ../../lib/xbrief/types.ts
 function subItemsOf(item) {
 	return item.items ?? item.subItems ?? [];
 }
-var VBRIEF_INSPECTION_POLICIES;
+var XBRIEF_INSPECTION_POLICIES;
 var init_types = __esmMin((() => {
-	VBRIEF_INSPECTION_POLICIES = [
+	XBRIEF_INSPECTION_POLICIES = [
 		"auto",
 		"never",
 		"fast",
@@ -492,25 +453,26 @@ var init_types = __esmMin((() => {
 	];
 }));
 //#endregion
-//#region ../../lib/vbrief/io.ts
+//#region ../../lib/xbrief/io.ts
 /**
-* vBRIEF File I/O Utilities
+* xBRIEF File I/O Utilities
 *
-* Single-spec-on-main model (PAN-1124): the canonical vBRIEF spec lives at
-* `<projectRoot>/.pan/specs/<canonical>.vbrief.json`. Work and task operations
-* cannot mutate its structure; they may only advance `plan.status` through
+* Single-spec model (PAN-1124): the canonical xBRIEF spec lives in `specs/`
+* on `overdeck-state` with a `.xbrief.json` filename behind the project state
+* read/write doors. Work and task operations cannot mutate its structure; they
+* may only advance `plan.status` through
 * `updateSpecStatus()` in `pan-dir/specs.ts`. A deliberate return to planning
 * may replace the full document at the same canonical path through
 * `writeSpecDocument()`, preserving stable item IDs so existing progress still
 * applies.
 *
 * Runtime item/subItem status is tracked as a flat `statusOverrides` map in
-* the workspace continue file (`<workspace>/.pan/continue.json`).
-* `readWorkspacePlan()` returns a merged view (main spec + overlay) so
+* the workspace continue file (`<workspace>/.overdeck/continue.json`).
+* `readWorkspacePlan()` returns a merged view (canonical spec + overlay) so
 * callers never need to know about the overlay.
 *
 * `updateItemStatus` and `updateSubItemStatus` write ONLY to the workspace
-* continue file — they cannot mutate the spec on main.
+* continue file — they cannot mutate the canonical spec.
 */
 /**
 * Synchronous spec lookup that mirrors what `findSpecByIssue` did pre-PAN-1249.
@@ -533,7 +495,7 @@ function findSpecByIssueSync(projectRoot, issueId) {
 	}
 	filenames.sort();
 	for (const filename of filenames) {
-		const parts = parseVBriefFilename(filename);
+		const parts = parseXBriefFilename(filename);
 		if (!parts) continue;
 		if (parts.issueId.toUpperCase() === upperIssueId) return { path: join(specsDir, filename) };
 	}
@@ -551,7 +513,7 @@ async function findSpecByIssueFromDisk(projectRoot, issueId) {
 	}
 	filenames.sort();
 	for (const filename of filenames) {
-		const parts = parseVBriefFilename(filename);
+		const parts = parseXBriefFilename(filename);
 		if (!parts) continue;
 		if (parts.issueId.toUpperCase() === upperIssueId) return { path: join(specsDir, filename) };
 	}
@@ -570,14 +532,26 @@ function projectRootFromWorkspace(workspacePath) {
 	return resolve(workspacePath, "..", "..");
 }
 function workspaceDraftPath(workspacePath) {
-	return join(workspacePath, PAN_DIRNAME, PAN_SPEC_FILENAME);
+	return getWorkspacePanPaths(workspacePath).specPath;
+}
+function readableWorkspaceDraftPath(workspacePath) {
+	const canonicalPath = workspaceDraftPath(workspacePath);
+	if (existsSync(canonicalPath)) return canonicalPath;
+	const legacyPath = getLegacyWorkspacePanPaths(workspacePath).specPath;
+	return existsSync(legacyPath) ? legacyPath : null;
 }
 function workspaceContinuePath(workspacePath) {
-	return join(workspacePath, PAN_DIRNAME, "continue.json");
+	return getWorkspacePanPaths(workspacePath).continuePath;
+}
+function readableWorkspaceContinuePath(workspacePath) {
+	const canonicalPath = workspaceContinuePath(workspacePath);
+	if (existsSync(canonicalPath)) return canonicalPath;
+	const legacyPath = getLegacyWorkspacePanPaths(workspacePath).continuePath;
+	return existsSync(legacyPath) ? legacyPath : canonicalPath;
 }
 function findWorkspaceDraftPlanSync(workspacePath) {
-	const path = workspaceDraftPath(workspacePath);
-	if (!existsSync(path)) return null;
+	const path = readableWorkspaceDraftPath(workspacePath);
+	if (!path) return null;
 	const issueId = issueIdFromWorkspacePath(workspacePath);
 	if (!issueId) return path;
 	try {
@@ -589,7 +563,7 @@ function findWorkspaceDraftPlanSync(workspacePath) {
 	return path;
 }
 /**
-* Returns the path to this workspace's vBRIEF source. The canonical main-side
+* Returns the path to this workspace's xBRIEF source. The canonical main-side
 * spec wins after promotion; before first promotion, the workspace draft is the
 * only valid source.
 *
@@ -604,35 +578,31 @@ function findPlanSync(workspacePath) {
 	const entry = findSpecByIssueSync(projectRootFromWorkspace(workspacePath), issueId);
 	return entry ? entry.path : findWorkspaceDraftPlanSync(workspacePath);
 }
-function normalizeVBriefEnvelope(parsed) {
+function normalizeXBriefEnvelope(parsed) {
 	if (!parsed || typeof parsed !== "object") return parsed;
 	const candidate = parsed;
-	if ("xBRIEFInfo" in candidate && !("vBRIEFInfo" in candidate)) {
-		const { xBRIEFInfo, ...rest } = candidate;
+	if ("vBRIEFInfo" in candidate && !("xBRIEFInfo" in candidate)) {
+		const { vBRIEFInfo, ...rest } = candidate;
 		return {
-			vBRIEFInfo: xBRIEFInfo,
+			xBRIEFInfo: vBRIEFInfo,
 			...rest
 		};
 	}
 	return parsed;
 }
-function serializeVBriefDocument(doc) {
-	const version = Number.parseFloat(doc.vBRIEFInfo.version);
-	if (Number.isFinite(version) && version >= .7) {
-		const { vBRIEFInfo, ...rest } = doc;
-		return JSON.stringify({
-			xBRIEFInfo: vBRIEFInfo,
-			...rest
-		}, null, 2);
-	}
-	return JSON.stringify(doc, null, 2);
+function serializeXBriefDocument(doc) {
+	const { xBRIEFInfo, vBRIEFInfo, ...rest } = doc;
+	return JSON.stringify({
+		xBRIEFInfo: xBRIEFInfo ?? vBRIEFInfo,
+		...rest
+	}, null, 2);
 }
 function readPlanSync(planPath) {
 	const raw = readFileSync(planPath, "utf-8");
-	if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) throw new VBriefMergeConflictError(planPath);
-	const parsed = normalizeVBriefEnvelope(JSON.parse(raw));
-	if (parsed.vBRIEFInfo && parsed.plan) return parsed;
-	throw new Error(`Invalid vBRIEF format in ${planPath}: missing 'vBRIEFInfo' or 'xBRIEFInfo' and/or 'plan' top-level keys. vBRIEF/xBRIEF v0.5-v0.8 requires { "vBRIEFInfo" or "xBRIEFInfo": { "version": "0.5" through "0.8" }, "plan": { ... } }. See docs/VBRIEF.md for the correct format.`);
+	if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) throw new XBriefMergeConflictError(planPath);
+	const parsed = normalizeXBriefEnvelope(JSON.parse(raw));
+	if (parsed.xBRIEFInfo && parsed.plan) return parsed;
+	throw new Error(`Invalid xBRIEF format in ${planPath}: missing 'xBRIEFInfo' or legacy 'vBRIEFInfo' and/or 'plan' top-level keys. xBRIEF v0.5-v0.8 requires { "xBRIEFInfo" or legacy "vBRIEFInfo": { "version": "0.5" through "0.8" }, "plan": { ... } }. See docs/XBRIEF.md for the correct format.`);
 }
 /**
 * Apply statusOverrides from workspace continue.json onto a deep-cloned spec.
@@ -675,7 +645,7 @@ function readStatusOverridesSync(workspacePath) {
 	return readIssueRecordSync(project, issueId)?.statusOverrides;
 }
 function readTierOverrides(workspacePath) {
-	const path = workspaceContinuePath(workspacePath);
+	const path = readableWorkspaceContinuePath(workspacePath);
 	try {
 		const raw = readFileSync(path, "utf-8");
 		return JSON.parse(raw).tierOverrides ?? {};
@@ -685,9 +655,10 @@ function readTierOverrides(workspacePath) {
 }
 function recordTierPromotion(workspacePath, itemId, from, to, reason) {
 	const path = workspaceContinuePath(workspacePath);
+	const readablePath = readableWorkspaceContinuePath(workspacePath);
 	let state = {};
 	try {
-		state = JSON.parse(readFileSync(path, "utf-8"));
+		state = JSON.parse(readFileSync(readablePath, "utf-8"));
 	} catch {
 		state = {};
 	}
@@ -706,14 +677,14 @@ function recordTierPromotion(workspacePath, itemId, from, to, reason) {
 			}]
 		}
 	};
-	mkdirSync(join(workspacePath, PAN_DIRNAME), { recursive: true });
+	mkdirSync(getWorkspacePanPaths(workspacePath).panDir, { recursive: true });
 	writeFileSync(path, JSON.stringify({
 		...state,
 		tierOverrides: nextOverrides
 	}, null, 2), "utf-8");
 }
 /**
-* Reads the vBRIEF plan for a workspace, returning a merged view with
+* Reads the xBRIEF plan for a workspace, returning a merged view with
 * statusOverrides applied from the per-issue record.
 * Returns null if no plan exists on main or locally.
 */
@@ -736,20 +707,20 @@ function readWorkspacePlanSync(workspacePath) {
 	if (overrides && Object.keys(overrides).length > 0) return applyStatusOverrides(doc, overrides);
 	return doc;
 }
-var VBriefMergeConflictTaggedError, VBriefInvalidFormatError, VBriefMergeConflictError, PLANNING_FINISHED_STATUSES, readPlan, findWorkspaceDraftPlan, findPlan, readWorkspacePlan, isPlanningComplete;
+var XBriefMergeConflictTaggedError, XBriefInvalidFormatError, XBriefMergeConflictError, PLANNING_FINISHED_STATUSES, readPlan, findWorkspaceDraftPlan, findPlan, readWorkspacePlan, isPlanningComplete;
 var init_io = __esmMin((() => {
+	init_continue();
 	init_specs();
 	init_record();
-	init_types$1();
 	init_lifecycle();
 	init_errors();
 	init_types();
-	VBriefMergeConflictTaggedError = class extends Data.TaggedError("VBriefMergeConflictError") {};
-	VBriefInvalidFormatError = class extends Data.TaggedError("VBriefInvalidFormatError") {};
-	VBriefMergeConflictError = class extends Error {
+	XBriefMergeConflictTaggedError = class extends Data.TaggedError("XBriefMergeConflictError") {};
+	XBriefInvalidFormatError = class extends Data.TaggedError("XBriefInvalidFormatError") {};
+	XBriefMergeConflictError = class extends Error {
 		constructor(planPath) {
-			super(`plan.vbrief.json at ${planPath} contains unresolved git merge conflict markers. Resolve all <<<<<<</=======/>>>>>>> markers in that file and commit the result before re-requesting review.`);
-			this.name = "VBriefMergeConflictError";
+			super(`xBRIEF document at ${planPath} contains unresolved git merge conflict markers. Resolve all <<<<<<</=======/>>>>>>> markers in that file and commit the result before re-requesting review.`);
+			this.name = "XBriefMergeConflictError";
 		}
 	};
 	PLANNING_FINISHED_STATUSES = new Set([
@@ -769,41 +740,46 @@ var init_io = __esmMin((() => {
 				cause
 			})
 		});
-		if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) return yield* Effect.fail(new VBriefMergeConflictTaggedError({ planPath }));
+		if (raw.includes("<<<<<<<") && raw.includes("=======") && raw.includes(">>>>>>>")) return yield* Effect.fail(new XBriefMergeConflictTaggedError({ planPath }));
 		let parsed;
 		try {
 			parsed = JSON.parse(raw);
 		} catch (cause) {
-			return yield* Effect.fail(new VBriefInvalidFormatError({
+			return yield* Effect.fail(new XBriefInvalidFormatError({
 				planPath,
 				reason: `invalid JSON: ${cause.message}`
 			}));
 		}
-		const obj = normalizeVBriefEnvelope(parsed);
-		if (!obj || !obj.vBRIEFInfo || !obj.plan) return yield* Effect.fail(new VBriefInvalidFormatError({
+		const obj = normalizeXBriefEnvelope(parsed);
+		if (!obj || !obj.xBRIEFInfo || !obj.plan) return yield* Effect.fail(new XBriefInvalidFormatError({
 			planPath,
-			reason: `missing 'vBRIEFInfo' or 'xBRIEFInfo' and/or 'plan' top-level keys`
+			reason: `missing 'xBRIEFInfo' or 'vBRIEFInfo' and/or 'plan' top-level keys`
 		}));
 		return obj;
 	});
 	findWorkspaceDraftPlan = (workspacePath) => Effect.gen(function* () {
-		const path = workspaceDraftPath(workspacePath);
-		if (!(yield* Effect.tryPromise({
+		const paths = [workspaceDraftPath(workspacePath), getLegacyWorkspacePanPaths(workspacePath).specPath];
+		let path = null;
+		for (const candidate of paths) if (yield* Effect.tryPromise({
 			try: async () => {
 				try {
-					await readFile(path, "utf-8");
+					await readFile(candidate, "utf-8");
 					return true;
 				} catch (error) {
-					if (error?.code === "ENOENT") return false;
+					if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return false;
 					throw error;
 				}
 			},
 			catch: (cause) => new FsError({
-				path,
+				path: candidate,
 				operation: "readFile",
 				cause
 			})
-		}))) return null;
+		})) {
+			path = candidate;
+			break;
+		}
+		if (!path) return null;
 		const issueId = issueIdFromWorkspacePath(workspacePath);
 		if (!issueId) return path;
 		const planIssueId = (yield* readPlan(path).pipe(Effect.orElseSucceed(() => null)))?.plan?.id;
@@ -851,6 +827,6 @@ var init_io = __esmMin((() => {
 	});
 }));
 //#endregion
-export { init_vbrief_index as A, init_specs as C, writeSpecDocument as D, writeSpec as E, generateVBriefFilename as F, init_lifecycle as I, parseVBriefFilename as L, readVBriefDocument as M, VBRIEF_LIFECYCLE_DIRS as N, writeSpecForIssue as O, ensureVBriefDirsSync as P, resolveVBriefDir as R, getProjectPanPaths as S, readSpec as T, VBRIEF_INSPECTION_POLICIES as _, findWorkspaceDraftPlan as a, ensurePanDirs as b, mergeRecordStatusOverrides as c, readPlanSync as d, readTierOverrides as f, serializeVBriefDocument as g, recordTierPromotion as h, findPlanSync as i, invalidateVBriefIndex as j, findVBriefByIssue as k, normalizeVBriefEnvelope as l, readWorkspacePlanSync as m, applyStatusOverrides as n, init_io as o, readWorkspacePlan as p, findPlan as r, isPlanningComplete as s, VBriefMergeConflictError as t, readPlan as u, init_types as v, listSpecs as w, findSpecByIssue as x, subItemsOf as y, slugify as z };
+export { init_xbrief_index as A, init_specs as C, writeSpecDocument as D, writeSpec as E, getReadableWorkspacePanPaths as F, getWorkspacePanPaths as I, init_continue as L, readXBriefDocument as M, ensureWorkspacePanDir as N, writeSpecForIssue as O, getLegacyWorkspacePanPaths as P, getProjectPanPaths as S, readSpec as T, XBRIEF_INSPECTION_POLICIES as _, findWorkspaceDraftPlan as a, ensurePanDirs as b, mergeRecordStatusOverrides as c, readPlanSync as d, readTierOverrides as f, serializeXBriefDocument as g, recordTierPromotion as h, findPlanSync as i, invalidateXBriefIndex as j, findXBriefByIssue as k, normalizeXBriefEnvelope as l, readWorkspacePlanSync as m, applyStatusOverrides as n, init_io as o, readWorkspacePlan as p, findPlan as r, isPlanningComplete as s, XBriefMergeConflictError as t, readPlan as u, init_types as v, listSpecs as w, findSpecByIssue as x, subItemsOf as y };
 
-//# sourceMappingURL=io-BiM-7Zsx.js.map
+//# sourceMappingURL=io-B3_AHDfr.js.map