@mulmoclaude/core 2.1.0 → 3.0.1

package/dist/{discovery-BvnXyUel.js → discovery-4Z-ZWFam.js}

@@ -42,6 +42,22 @@ function createForwardingLogger(getLogger) {
 }
 //#endregion
 //#region src/collection/server/host.ts
+/** `err.code` on the throw from `getWorkspaceRoot()` under an explicit-root
+*  binding: this CALL is missing its `workspaceRoot` option. Exported because
+*  the fix differs from a watcher root conflict — that one means another root's
+*  watcher is already running — and a host catching both in one place should
+*  not have to match on message text to tell them apart. */
+var COLLECTION_ROOT_REQUIRED = "COLLECTION_ROOT_REQUIRED";
+/** Build a change payload, attaching `root` only when the engine call carried
+*  an explicit one. Centralised so every publish site states the root the same
+*  way, and so a single-workspace host's payload shape stays byte-identical to
+*  what it saw before multi-root support. */
+function collectionChangePayload(base, root) {
+	return root === void 0 ? base : {
+		...base,
+		root
+	};
+}
 var hostSlot = createHostSlot("@mulmoclaude/core/collection/server: configureCollectionHost()");
 var changePublisher = null;
 /** Wire the engine to a host. Call once at server startup, before any
@@ -70,9 +86,23 @@ function publishCollectionChange(payload) {
 function requireHost() {
 	return hostSlot.get();
 }
-/** The configured workspace root. Throws if the host never configured one. */
+/** The configured workspace root. Throws if the host never configured one —
+*  and, under an explicit-root binding (`workspaceRoot: null`), throws rather
+*  than guessing, which is the whole point of that mode: on a multi-root host
+*  a missing `opts.workspaceRoot` must fail loudly instead of silently
+*  resolving against some other project. */
 function getWorkspaceRoot() {
-	return requireHost().workspaceRoot;
+	const root = requireHost().workspaceRoot;
+	if (root === null) throw Object.assign(/* @__PURE__ */ new Error("@mulmoclaude/core/collection/server: the host is bound in explicit-root mode (workspaceRoot: null), so there is no ambient workspace root — pass an explicit `workspaceRoot` in this call's options."), { code: COLLECTION_ROOT_REQUIRED });
+	return root;
+}
+/** The configured workspace root, or `null` under an explicit-root binding /
+*  before the host configures one. Never throws — for callers that need to
+*  COMPARE roots (is this the one we are already running for?) rather than
+*  operate on one. Anything that will touch the filesystem wants
+*  `getWorkspaceRoot()` and its loud failure instead. */
+function peekWorkspaceRoot() {
+	return hostSlot.peek()?.workspaceRoot ?? null;
 }
 function userSkillsDir() {
 	return requireHost().paths.userSkillsDir;
@@ -89,10 +119,11 @@ function skillsStagingDir(workspaceRoot) {
 function archiveDir() {
 	return requireHost().paths.archiveDir;
 }
-/** Absolute path to the configured workspace's `collections-registries.json`. */
-function collectionsRegistriesConfigPath() {
-	const host = requireHost();
-	return host.paths.collectionsRegistriesConfig(host.workspaceRoot);
+/** Absolute path to a workspace's `collections-registries.json`. Takes the
+*  root explicitly — reading the ambient one here would throw under an
+*  explicit-root binding and take the Discover tab down with it. */
+function collectionsRegistriesConfigPath(workspaceRoot) {
+	return requireHost().paths.collectionsRegistriesConfig(workspaceRoot);
 }
 function isPresetSlug(slug) {
 	return requireHost().isPresetSlug(slug);
@@ -171,11 +202,6 @@ function isContainedInRoot(absPath, rootPath) {
 	if (ancestorReal === rootReal) return true;
 	return ancestorReal.startsWith(rootReal + path.sep);
 }
-/** Workspace-bound convenience over `isContainedInRoot`. Production
-*  callers use this; the tests exercise the pure helper. */
-function isContainedInWorkspace(absPath) {
-	return isContainedInRoot(absPath, getWorkspaceRoot());
-}
 /** Resolve a schema-declared dataPath against `rootPath` (default:
 *  the live workspace), refusing anything that escapes — absolute
 *  paths, `..`-segments, empty string, or symlinks pointing outside
@@ -383,11 +409,11 @@ async function writeItem(dataDir, itemId, item, opts = {}) {
 			await handle.close();
 		}
 	} else await writeFileAtomic(filePath, payload);
-	if (opts.slug) publishCollectionChange({
+	if (opts.slug) publishCollectionChange(collectionChangePayload({
 		slug: opts.slug,
 		ids: [safeId],
 		op: "upsert"
-	});
+	}, opts.workspaceRoot));
 	return {
 		kind: "ok",
 		itemId: safeId,
@@ -407,11 +433,11 @@ async function deleteItem(dataDir, itemId, opts = {}) {
 	const filePath = itemFilePath(dataDir, safeId);
 	try {
 		await unlink(filePath);
-		if (opts.slug) publishCollectionChange({
+		if (opts.slug) publishCollectionChange(collectionChangePayload({
 			slug: opts.slug,
 			ids: [safeId],
 			op: "delete"
-		});
+		}, opts.workspaceRoot));
 		return {
 			kind: "ok",
 			itemId: safeId
@@ -1237,11 +1263,11 @@ async function sqliteWrite(absPath, itemId, item, opts) {
 			item
 		};
 	});
-	if (outcome.kind === "ok" && opts.slug) publishCollectionChange({
+	if (outcome.kind === "ok" && opts.slug) publishCollectionChange(collectionChangePayload({
 		slug: opts.slug,
 		ids: [safeId],
 		op: "upsert"
-	});
+	}, opts.publishRoot));
 	return outcome;
 }
 async function sqliteDelete(absPath, itemId, opts) {
@@ -1266,11 +1292,11 @@ async function sqliteDelete(absPath, itemId, opts) {
 			itemId: safeId
 		};
 	});
-	if (outcome.kind === "ok" && opts.slug) publishCollectionChange({
+	if (outcome.kind === "ok" && opts.slug) publishCollectionChange(collectionChangePayload({
 		slug: opts.slug,
 		ids: [safeId],
 		op: "delete"
-	});
+	}, opts.publishRoot));
 	return outcome;
 }
 /** Best-effort full WAL checkpoint so the MAIN db file alone is a
@@ -1301,6 +1327,7 @@ function sqliteStoreFor(collection, opts) {
 	const key = collection.schema.primaryKey;
 	const slug = opts.slug ?? collection.slug;
 	const root = () => opts.workspaceRoot ?? getWorkspaceRoot();
+	const publishRoot = opts.workspaceRoot;
 	if (file === void 0) return {
 		capabilities: {
 			writable: false,
@@ -1326,11 +1353,13 @@ function sqliteStoreFor(collection, opts) {
 		read: (itemId) => sqliteRead(file, itemId, root()),
 		write: (itemId, item, writeOpts = {}) => sqliteWrite(file, itemId, item, {
 			workspaceRoot: root(),
+			publishRoot,
 			slug,
 			refuseOverwrite: writeOpts.refuseOverwrite
 		}),
 		delete: (itemId) => sqliteDelete(file, itemId, {
 			workspaceRoot: root(),
+			publishRoot,
 			slug
 		}),
 		watch: async (onChange) => closerFor(await watchSingleFile(file, (base, name) => name.startsWith(base), () => onChange({ kind: "collection" })))
@@ -2721,6 +2750,6 @@ function toDetail(collection) {
 	};
 }
 //#endregion
-export { skillsStagingDir as $, deleteItem as A, itemFilePath as B, compileCsvQuery as C, MAX_QUERY_ROWS as D, DEFAULT_QUERY_ROWS as E, resolveCreateItemId as F, archiveDir as G, resolveTemplatePath as H, writeItem as I, getWorkspaceRoot as J, collectionsRegistriesConfigPath as K, SCHEMA_FILE as L, isRegularFile as M, listItems as N, BackendUnavailableError as O, readItem as P, setCollectionChangePublisher as Q, isContainedInRoot as R, queryCsv as S, CollectionQueryZ as T, safeRecordId as U, resolveDataDir as V, safeSlugName as W, log as X, isPresetSlug as Y, publishCollectionChange as Z, csvRowToItem as _, toDetail as a, encodeCsvRecordId as b, resolveMutateSet as c, storeFor as d, createForwardingLogger as et, checkpointSqliteDatabase as f, cacheDir as g, MAX_CSV_ROWS as h, resolvePrimaryField as i, generateItemId as j, isBackendUnavailable as k, collectionWritable as l, projectItemFields as m, discoverCollections as n, toSummary as o, pageFromFullRead as p, configureCollectionHost as q, loadCollection as r, CollectionSchemaZ as s, acceptParsedSchema as t, createHostSlot as tt, readOnlyRefusal as u, decodeCsvRecordId as v, compileJsonlQuery as w, normalizeCsvValue as x, dedupeByRecordId as y, isContainedInWorkspace as z };
+export { publishCollectionChange as $, deleteItem as A, resolveDataDir as B, compileCsvQuery as C, MAX_QUERY_ROWS as D, DEFAULT_QUERY_ROWS as E, resolveCreateItemId as F, archiveDir as G, safeRecordId as H, writeItem as I, configureCollectionHost as J, collectionChangePayload as K, SCHEMA_FILE as L, isRegularFile as M, listItems as N, BackendUnavailableError as O, readItem as P, peekWorkspaceRoot as Q, isContainedInRoot as R, queryCsv as S, CollectionQueryZ as T, safeSlugName as U, resolveTemplatePath as V, COLLECTION_ROOT_REQUIRED as W, isPresetSlug as X, getWorkspaceRoot as Y, log as Z, csvRowToItem as _, toDetail as a, encodeCsvRecordId as b, resolveMutateSet as c, storeFor as d, setCollectionChangePublisher as et, checkpointSqliteDatabase as f, cacheDir as g, MAX_CSV_ROWS as h, resolvePrimaryField as i, generateItemId as j, isBackendUnavailable as k, collectionWritable as l, projectItemFields as m, discoverCollections as n, createForwardingLogger as nt, toSummary as o, pageFromFullRead as p, collectionsRegistriesConfigPath as q, loadCollection as r, createHostSlot as rt, CollectionSchemaZ as s, acceptParsedSchema as t, skillsStagingDir as tt, readOnlyRefusal as u, decodeCsvRecordId as v, compileJsonlQuery as w, normalizeCsvValue as x, dedupeByRecordId as y, itemFilePath as z };
 
-//# sourceMappingURL=discovery-BvnXyUel.js.map
+//# sourceMappingURL=discovery-4Z-ZWFam.js.map