@lmzhen/dsh-evolution-skill-discovery 0.32.3 → 0.32.4

package/lib/main-entry.js

@@ -1,10 +1,18 @@
 import { isAbsolute, join, resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
-import { authorityFrom, evolutionIoAdapter, evolutionRoot, installEvolutionProjections, isRecord, makeSerialQueue, newSkillLibrary, parseFrontmatter } from "@lmzhen/dsh-evolution-core";
+import { authorityFrom, evolutionIoAdapter, evolutionRoot, installEvolutionProjections, isRecord, makeSerialQueue, newSkillLibrary } from "@lmzhen/dsh-evolution-core";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { escapeText } from "@deepseek-ai/dsh-skill";
 import MiniSearch from "minisearch";
 import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region lib/types/domain-map.js
+/** The next CAS version. ONE implementation: non-numeric versions get a suffix,
+* never NaN, and every writer advances the same way. */
+function nextMapVersion(version) {
+	const numeric = Number(version);
+	return Number.isSafeInteger(numeric) && numeric >= 0 ? String(numeric + 1) : version + ".1";
+}
+//#endregion
 //#region lib/types/domain-generation.js
 /** @returns stable id derived from title, not the title itself. */
 function mintDomainId(title) {
@@ -127,6 +135,7 @@ async function bootstrapDomainMapWithFacts(store, proposal, facts, expectedMapVe
 		descriptionHash: "bootstrap",
 		descriptionVersion: 1,
 		descriptionStatus: "fresh",
+		descriptionUpdatedAt: now,
 		provenance: {
 			source: "llm",
 			promptVersion: provenance.promptVersion,
@@ -156,7 +165,7 @@ async function bootstrapDomainMapWithFacts(store, proposal, facts, expectedMapVe
 		});
 	}
 	return store.commit(expectedMapVersion, {
-		mapVersion: String(Number(expectedMapVersion) + 1),
+		mapVersion: nextMapVersion(expectedMapVersion),
 		domains,
 		edges
 	});
@@ -236,11 +245,7 @@ const ALLOWED = new Set([
 	"disableDomains",
 	"revision"
 ]);
-const MODES = new Set([
-	"off",
-	"auto",
-	"on"
-]);
+const MODES = new Set(["off", "on"]);
 function checkLayer(layer) {
 	for (const key of Object.keys(layer)) if (!ALLOWED.has(key)) throw new DomainPolicyValidationError("unsupported policy field " + key);
 	if (layer.mode !== void 0 && !MODES.has(layer.mode)) throw new DomainPolicyValidationError("unsupported policy mode");
@@ -303,7 +308,7 @@ function canonical(value) {
 	if (typeof value === "object" && value !== null) return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([key, entry]) => [key, canonical(entry)]));
 	return value;
 }
-function digest$1(value) {
+function digest(value) {
 	return sha256(JSON.stringify(canonical(value)));
 }
 /** @returns stable key for the winning provider/source/name tuple. */
@@ -316,11 +321,11 @@ function skillKeyOf(summary) {
 }
 /** @returns stable hash of the canonical cwd and optional scope key. */
 function viewKeyOf(input) {
-	return digest$1([resolve(input.cwd), input.scopeKey ?? null]);
+	return digest([resolve(input.cwd), input.scopeKey ?? null]);
 }
 /** @returns hash of the three fields used by discovery/retrieval. */
 function threeFieldHashOf(input) {
-	return digest$1([
+	return digest([
 		input.name,
 		input.description,
 		input.whenToUse ?? null
@@ -344,7 +349,7 @@ function skillIndexRowOf(summary, managed, protectedSkill = false, pinned = fals
 }
 /** @returns digest of the sorted rows plus completeness. */
 function catalogRevisionOf(rows, complete) {
-	return digest$1([complete, rows.map((row) => [
+	return digest([complete, rows.map((row) => [
 		row.skillKey,
 		row.name,
 		row.description,
@@ -360,11 +365,11 @@ function catalogRevisionOf(rows, complete) {
 }
 /** @returns digest of a concrete per-view snapshot. */
 function viewCatalogDigestOf(viewKey, rows, complete) {
-	return digest$1([viewKey, catalogRevisionOf(rows, complete)]);
+	return digest([viewKey, catalogRevisionOf(rows, complete)]);
 }
 /** @returns digest of effective policy plus its revisions. */
 function policyDigestOf(input) {
-	return digest$1([
+	return digest([
 		input.globalPolicyRevision,
 		input.workspaceOverlayRevision ?? null,
 		input.scopeOverlayRevision ?? null,
@@ -373,7 +378,7 @@ function policyDigestOf(input) {
 }
 /** @returns view-cache identity for one projection. */
 function projectionDigestOf(input) {
-	return digest$1([
+	return digest([
 		input.viewKey,
 		input.mapVersion,
 		input.policyDigest,
@@ -385,7 +390,7 @@ function projectionDigestOf(input) {
 }
 /** @returns view-cache identity for one search index. */
 function searchIndexKeyOf(input) {
-	return digest$1([
+	return digest([
 		input.viewKey,
 		input.viewCatalogDigest,
 		input.policyDigest,
@@ -875,7 +880,7 @@ function buildDomainProjection(input) {
 	const linkedKeys = new Set(input.snapshot.edges.filter((edge) => edge.status === "active" || edge.status === "pending").map((edge) => edge.skillKey));
 	const unclassifiedCount = input.rows.filter((row) => row.modelInvocable && !linkedKeys.has(row.skillKey)).length;
 	const domains = input.snapshot.domains.filter((node) => node.status === "active" || node.status === "provisional");
-	const cardDomains = domains.filter((node) => node.parentIds.length <= (input.maxVisibleDepth ?? 3) - 1 && node.parentIds.length === 0).filter((node) => !input.policy.disabled.has(node.id)).filter((node) => input.policy.pinned.has(node.id) || qualityPasses(node, domains)).sort((left, right) => left.id < right.id ? -1 : left.id > right.id ? 1 : 0).slice(0, Math.max(1, input.maxCards ?? 12));
+	const cardDomains = domains.filter((node) => node.parentIds.length === 0).filter((node) => !input.policy.disabled.has(node.id)).filter((node) => input.policy.pinned.has(node.id) || qualityPasses(node, domains)).sort((left, right) => left.id < right.id ? -1 : left.id > right.id ? 1 : 0).slice(0, Math.max(1, input.maxCards ?? 12));
 	const domainById = new Map(domains.map((node) => [node.id, node]));
 	const cards = cardDomains.map((node) => {
 		let managedModelInvocableCount = 0;
@@ -897,7 +902,7 @@ function buildDomainProjection(input) {
 			id: node.id,
 			title: node.name,
 			purpose: node.purpose.slice(0, 80),
-			descriptionStatus: node.descriptionStatus === "fresh" && input.descriptionStaleAfterHours !== void 0 && input.now !== void 0 && input.now - node.updatedAt > input.descriptionStaleAfterHours * 36e5 ? "stale" : node.descriptionStatus,
+			descriptionStatus: node.descriptionStatus === "fresh" && input.descriptionStaleAfterHours !== void 0 && input.now !== void 0 && input.now - (node.descriptionUpdatedAt ?? node.updatedAt) > input.descriptionStaleAfterHours * 36e5 ? "stale" : node.descriptionStatus,
 			triggers: node.triggers.slice(0, 3),
 			managedModelInvocableCount,
 			externalCatalogCount,
@@ -926,7 +931,7 @@ function buildDomainProjection(input) {
 		wouldHide.add(edge.skillKey);
 	}
 	const activeManaged = mode === "on" && !mapStale && input.searchAvailable !== false && input.policy.degraded.length === 0 ? wouldHide : /* @__PURE__ */ new Set();
-	const projected = projectCatalog({
+	return projectCatalog({
 		entries: input.entries,
 		rows: input.rows,
 		activeManagedSkillKeys: activeManaged,
@@ -941,7 +946,6 @@ function buildDomainProjection(input) {
 		discoveryMode: input.discoveryMode,
 		complete: true
 	});
-	return mode === "on" ? projected : projected;
 }
 //#endregion
 //#region lib/types/skill-index.js
@@ -1182,7 +1186,7 @@ function applyProjectedDecision(decision, capture, result, seen) {
 /**
 * Derive one view's state without consulting another view.
 * @param input - per-view health and identity.
-* @returns state with reasons; hidden safety is evaluated by canHide.
+* @returns state with reasons; card rendering is gated by canProject.
 */
 function deriveViewState(input) {
 	const reasons = [...input.reasons ?? []];
@@ -1274,7 +1278,7 @@ function mapStateOf(snapshot, staleAfterHours, now) {
 	return "ready";
 }
 function effectiveMode(mode) {
-	return mode === "off" ? "off" : mode === "auto" ? "shadow" : "on";
+	return mode;
 }
 function catalogText(message) {
 	return message.content.map((block) => block.type === "text" ? block.text ?? "" : "").join("");
@@ -1352,6 +1356,7 @@ var ProjectionRuntime = class {
 		at: 0
 	};
 	lastByAgent = /* @__PURE__ */ new Map();
+	warnedMissingHistory = false;
 	constructor(ports) {
 		this.ports = ports;
 	}
@@ -1359,6 +1364,14 @@ var ProjectionRuntime = class {
 	report(agent) {
 		return agent === void 0 ? this.last : this.lastByAgent.get(String(agent.id)) ?? this.last;
 	}
+	hasStructuralLog(agent) {
+		return typeof agent.session.readEvents === "function";
+	}
+	warnMissingHistory() {
+		if (this.warnedMissingHistory) return;
+		this.warnedMissingHistory = true;
+		this.ports.warn?.("evolution-skill-discovery: no sessionProjections history and no structural readEvents for this session — catalog restore/dedupe is unavailable; failing open (mount the projection registry to keep replacement dedupe)");
+	}
 	mark(agent, action, digest, content = "") {
 		const report = {
 			action,
@@ -1382,6 +1395,10 @@ var ProjectionRuntime = class {
 		const fullCurrent = currentCapture === void 0 ? void 0 : fullCaptureOf(currentCapture);
 		const durable = projectedCurrent ? record?.base ?? fullSession ?? fullCurrent : fullCurrent ?? fullSession ?? record?.base;
 		if (durable === void 0) {
+			if (history === void 0 && !this.hasStructuralLog(agent)) {
+				this.warnMissingHistory();
+				return decision;
+			}
 			this.mark(agent, "blocked", "");
 			return decision;
 		}
@@ -1460,6 +1477,7 @@ var ProjectionRuntime = class {
 		const { view, snapshot, policy, policyDigest, state } = await this.readState(agent, signal);
 		const currentCapture = captureDecisionCatalog(decision);
 		const history = this.ports.history?.(agent);
+		if (history === void 0 && !this.hasStructuralLog(agent)) this.warnMissingHistory();
 		const seen = new Set(sessionProjectionDigests(agent, history));
 		if (decision.kind === "enter") for (const message of decision.messages) {
 			if (message.source.kind !== "evolution-skill-projection") continue;
@@ -1473,6 +1491,7 @@ var ProjectionRuntime = class {
 		if (capture === void 0) capture = sessionCatalogCapture(agent, history);
 		if (!canProject(state) || snapshot === void 0) return this.restore(agent, view.viewKey, decision, currentCapture);
 		if (capture === void 0) {
+			if (history === void 0 && !this.hasStructuralLog(agent)) return decision;
 			this.mark(agent, "blocked", "");
 			return decision;
 		}
@@ -1647,6 +1666,14 @@ var SkillSearchIndex = class SkillSearchIndex {
 /** Per-view cache keyed by searchIndexKey; never shares one engine across views. */
 var SkillSearchCache = class {
 	entries = /* @__PURE__ */ new Map();
+	maxEntries;
+	constructor(options = {}) {
+		this.maxEntries = Math.max(1, Math.floor(options.maxEntries ?? 32));
+	}
+	/** @returns the current number of cached view indices (bounded by maxEntries). */
+	get size() {
+		return this.entries.size;
+	}
 	/**
 	* Get or build one view index. A failed rebuild retains the previous engine
 	* and marks it stale; no previous engine means undefined.
@@ -1664,10 +1691,14 @@ var SkillSearchCache = class {
 			discoveryMode: key.discoveryMode
 		});
 		const existing = this.entries.get(cacheKey);
-		if (existing !== void 0) return {
-			index: existing.index,
-			stale: false
-		};
+		if (existing !== void 0) {
+			this.entries.delete(cacheKey);
+			this.entries.set(cacheKey, existing);
+			return {
+				index: existing.index,
+				stale: false
+			};
+		}
 		try {
 			const index = SkillSearchIndex.fromRows(key.viewKey, rows);
 			this.entries.set(cacheKey, {
@@ -1675,6 +1706,11 @@ var SkillSearchCache = class {
 				viewKey: key.viewKey,
 				index
 			});
+			while (this.entries.size > this.maxEntries) {
+				const oldest = this.entries.keys().next().value;
+				if (oldest === void 0) break;
+				this.entries.delete(oldest);
+			}
 			return {
 				index,
 				stale: false
@@ -1978,12 +2014,49 @@ function buildGenerationRequest(input) {
 var ViewSnapshotStore = class {
 	io;
 	path;
+	serial = Promise.resolve();
 	constructor(io, path) {
 		this.io = io;
 		this.path = path;
 	}
 	async read() {
-		const content = await this.io.readText(this.path);
+		return this.decode(await this.io.readText(this.path));
+	}
+	/** Persist one session snapshot; first writer wins unless overwrite is explicit. */
+	async put(snapshot, options = {}) {
+		const apply = (raw) => {
+			const current = this.decode(raw);
+			if (current.sessions[snapshot.sessionId] !== void 0 && options.overwrite !== true) return raw;
+			const sessions = {
+				...current.sessions,
+				[snapshot.sessionId]: {
+					viewKey: snapshot.viewKey,
+					cwd: snapshot.cwd,
+					viewCatalogDigest: snapshot.viewCatalogDigest,
+					mapVersion: snapshot.mapVersion,
+					configDigest: snapshot.configDigest,
+					featureEpoch: snapshot.featureEpoch,
+					createdAt: snapshot.createdAt
+				}
+			};
+			return JSON.stringify({
+				schemaVersion: 1,
+				sessions
+			});
+		};
+		if (this.io.transact !== void 0) {
+			await this.io.transact(this.path, (current) => apply(current));
+			return;
+		}
+		const task = async () => {
+			const current = await this.io.readText(this.path);
+			const next = apply(current);
+			if (next !== null && next !== current) await this.io.writeText(this.path, next);
+		};
+		this.serial = this.serial.then(task, task);
+		await this.serial;
+	}
+	decode(content) {
 		if (content === null) return {
 			schemaVersion: 1,
 			sessions: {}
@@ -2004,27 +2077,6 @@ var ViewSnapshotStore = class {
 			};
 		}
 	}
-	/** Persist one session snapshot; first writer wins unless overwrite is explicit. */
-	async put(snapshot, options = {}) {
-		const current = await this.read();
-		if (current.sessions[snapshot.sessionId] !== void 0 && options.overwrite !== true) return;
-		const sessions = {
-			...current.sessions,
-			[snapshot.sessionId]: {
-				viewKey: snapshot.viewKey,
-				cwd: snapshot.cwd,
-				viewCatalogDigest: snapshot.viewCatalogDigest,
-				mapVersion: snapshot.mapVersion,
-				configDigest: snapshot.configDigest,
-				featureEpoch: snapshot.featureEpoch,
-				createdAt: snapshot.createdAt
-			}
-		};
-		await this.io.writeText(this.path, JSON.stringify({
-			schemaVersion: 1,
-			sessions
-		}));
-	}
 	/** @returns frozen snapshot for one session, if recorded. */
 	async get(sessionId) {
 		const entry = (await this.read()).sessions[sessionId];
@@ -2042,506 +2094,6 @@ var ViewSnapshotStore = class {
 	}
 };
 //#endregion
-//#region lib/types/assignment.js
-function digest(value) {
-	return createHash("sha256").update(JSON.stringify(value)).digest("hex");
-}
-/** @returns idempotency key for one proposal observation. */
-function assignmentKey(input) {
-	return digest([
-		input.skillKey,
-		input.threeFieldHash,
-		input.proposalDigest,
-		input.mapVersion
-	]);
-}
-/** @returns stable proposal digest; undefined proposal is digest of null. */
-function proposalDigest(proposal) {
-	return digest(proposal ?? null);
-}
-/** @returns a closed-set pending reason or undefined when the proposal can enqueue. */
-function validateProposal(proposal) {
-	if (proposal.mode !== "existing" && proposal.mode !== "new") return "schema-invalid";
-	if (typeof proposal.confidence !== "number" || proposal.confidence < 0 || proposal.confidence > 1 || typeof proposal.reason !== "string" || typeof proposal.mapVersion !== "string") return "schema-invalid";
-	if (proposal.mode === "existing" && (typeof proposal.id !== "string" || proposal.id.length === 0)) return "invalid-id";
-	if (proposal.mode === "new") {
-		const proposed = proposal.proposed;
-		if (proposed === void 0 || proposed.title.trim().length === 0 || proposed.purpose.trim().length === 0 || proposed.inScope.length === 0 || proposed.outOfScope.length === 0 || proposed.triggers.length === 0) return "new-domain-conflict";
-	}
-}
-/** @returns true only when whenToUse is covered by in/out/triggers; names alone do not count. */
-function coveredByDomain(whenToUse, domain) {
-	const text = whenToUse.toLowerCase();
-	if (text.length === 0) return false;
-	if (domain.outOfScope.some((value) => value.length > 0 && text.includes(value.toLowerCase()))) return false;
-	return domain.triggers.some((value) => value.length > 0 && text.includes(value.toLowerCase())) || domain.inScope.some((value) => value.length > 0 && text.includes(value.toLowerCase()));
-}
-/** One assignment sidecar service; the only map write path for create. */
-var DomainAssignmentService = class {
-	queue;
-	store;
-	options;
-	constructor(queue, store, options) {
-		this.queue = queue;
-		this.store = store;
-		this.options = options;
-	}
-	/** Stage a create proposal without queueing it. */
-	stage(submission) {
-		return {
-			id: digest([
-				"staged",
-				submission.skillKey,
-				submission.threeFieldHash
-			]),
-			submission
-		};
-	}
-	/** Approve a staged create; only this call enqueues. */
-	async approve(staged) {
-		return this.submit(staged.submission);
-	}
-	/**
-	* Submit a create proposal after SkillLibrary.create succeeded.
-	* @param submission - skill identity, three-field hash, permission, proposal.
-	* @returns queue/pending/unclassified; never rolls back create.
-	*/
-	async submit(submission) {
-		if (!this.options.createClassificationEnabled) return {
-			kind: "unclassified",
-			reason: "feature-off"
-		};
-		if (!submission.modelInvocable) return {
-			kind: "unclassified",
-			reason: "not-model-invocable"
-		};
-		if (submission.proposal === void 0) {
-			if (this.options.createCardsAvailable === true) {
-				const reason = "schema-invalid";
-				return {
-					kind: "pending",
-					entry: {
-						key: digest([
-							"missing-proposal",
-							submission.skillKey,
-							submission.threeFieldHash
-						]),
-						submission,
-						proposalDigest: proposalDigest(void 0),
-						createdAt: this.now(),
-						status: "pending",
-						pendingReason: reason
-					},
-					reason
-				};
-			}
-			return {
-				kind: "unclassified",
-				reason: "no-proposal"
-			};
-		}
-		const invalid = validateProposal(submission.proposal);
-		const pdigest = proposalDigest(submission.proposal);
-		const key = assignmentKey({
-			skillKey: submission.skillKey,
-			threeFieldHash: submission.threeFieldHash,
-			proposalDigest: pdigest,
-			mapVersion: submission.proposal.mapVersion
-		});
-		let queued;
-		try {
-			queued = await this.queue.enqueue({
-				key,
-				submission,
-				proposalDigest: pdigest,
-				createdAt: submission.now ?? this.now()
-			});
-		} catch {
-			return {
-				kind: "pending",
-				entry: {
-					key,
-					submission,
-					proposalDigest: pdigest,
-					createdAt: submission.now ?? this.now(),
-					status: "pending",
-					pendingReason: "queue-unavailable"
-				},
-				reason: "queue-unavailable"
-			};
-		}
-		if (invalid !== void 0) {
-			await this.queue.update(key, "pending", invalid);
-			return {
-				kind: "pending",
-				entry: {
-					...queued.entry,
-					status: "pending",
-					pendingReason: invalid
-				},
-				reason: invalid
-			};
-		}
-		return {
-			kind: "queued",
-			entry: queued.entry,
-			duplicate: queued.duplicate
-		};
-	}
-	/** Process one queued entry with the current map; CAS failure becomes pending. */
-	async process(entry) {
-		const proposal = entry.submission.proposal;
-		if (proposal === void 0) return {
-			kind: "pending",
-			entry,
-			reason: "schema-invalid"
-		};
-		const current = await this.store.read();
-		if (proposal.mapVersion !== current.mapVersion) {
-			await this.queue.update(entry.key, "pending", "map-version-stale");
-			return {
-				kind: "pending",
-				entry: {
-					...entry,
-					status: "pending",
-					pendingReason: "map-version-stale"
-				},
-				reason: "map-version-stale"
-			};
-		}
-		try {
-			const next = buildNext(current, entry, proposal, this.options.provisionalThreshold ?? 3);
-			const committed = await this.store.commit(current.mapVersion, {
-				mapVersion: next.mapVersion,
-				domains: next.domains,
-				edges: next.edges
-			});
-			const status = next.provisional ? "provisional" : "applied";
-			await this.queue.update(entry.key, status);
-			return {
-				kind: status,
-				entry: {
-					...entry,
-					status
-				},
-				mapVersion: committed.mapVersion
-			};
-		} catch (error) {
-			if (error instanceof DomainMapVersionConflict) {
-				await this.queue.update(entry.key, "pending", "map-version-stale");
-				return {
-					kind: "pending",
-					entry: {
-						...entry,
-						status: "pending",
-						pendingReason: "map-version-stale"
-					},
-					reason: "map-version-stale"
-				};
-			}
-			const reason = error instanceof Error && (error.message === "unknown-domain" || error.message === "new-domain-conflict" || error.message === "schema-invalid") ? error.message : "queue-unavailable";
-			await this.queue.update(entry.key, "pending", reason);
-			return {
-				kind: "pending",
-				entry: {
-					...entry,
-					status: "pending",
-					pendingReason: reason
-				},
-				reason
-			};
-		}
-	}
-	/** Manually confirm one provisional domain; no semantic reclassification. */
-	async confirm(domainId) {
-		const current = await this.store.read();
-		const domain = current.domains.find((node) => node.id === domainId);
-		if (domain === void 0 || domain.status !== "provisional") return false;
-		const domains = current.domains.map((node) => node.id === domainId ? {
-			...node,
-			status: "active",
-			updatedAt: this.now()
-		} : node);
-		await this.store.commit(current.mapVersion, {
-			mapVersion: nextMapVersion$1(current.mapVersion),
-			domains,
-			edges: current.edges
-		});
-		return true;
-	}
-	now() {
-		return this.options.now?.() ?? Date.now();
-	}
-};
-function nextMapVersion$1(version) {
-	const numeric = Number(version);
-	return Number.isSafeInteger(numeric) && numeric >= 0 ? String(numeric + 1) : version + "+1";
-}
-function buildNext(current, entry, proposal, threshold) {
-	const edge = {
-		skillKey: entry.submission.skillKey,
-		domainId: "",
-		role: "primary",
-		confidence: proposal.confidence,
-		source: "create",
-		skillHash: entry.submission.threeFieldHash,
-		mapVersion: nextMapVersion$1(current.mapVersion),
-		status: "active",
-		assignedAt: entry.createdAt
-	};
-	const secondaries = (proposal.secondaryDomainIds ?? []).map((id) => {
-		const secondary = current.domains.find((node) => node.id === id);
-		if (secondary === void 0) throw new Error("unknown-domain");
-		return {
-			...edge,
-			domainId: secondary.id,
-			role: "secondary"
-		};
-	});
-	if (proposal.mode === "existing") {
-		const domain = current.domains.find((node) => node.id === proposal.id);
-		if (domain === void 0) throw new Error("unknown-domain");
-		if (!coveredByDomain(entry.submission.whenToUse ?? "", domain)) throw new Error("new-domain-conflict");
-		const members = new Set(current.edges.filter((item) => item.domainId === domain.id).map((item) => item.skillKey));
-		members.add(entry.submission.skillKey);
-		const promote = domain.status === "provisional" && members.size >= threshold;
-		const domains = promote ? current.domains.map((node) => node.id === domain.id ? {
-			...node,
-			status: "active",
-			updatedAt: entry.createdAt
-		} : node) : current.domains;
-		return {
-			mapVersion: nextMapVersion$1(current.mapVersion),
-			domains,
-			edges: [
-				...current.edges,
-				{
-					...edge,
-					domainId: domain.id
-				},
-				...secondaries.filter((secondary) => secondary.domainId !== domain.id)
-			],
-			provisional: domain.status === "provisional" && !promote
-		};
-	}
-	const proposed = proposal.proposed;
-	if (proposed === void 0) throw new Error("schema-invalid");
-	const normalizedTitle = proposed.title.trim().toLowerCase();
-	const existing = current.domains.find((node) => node.name.trim().toLowerCase() === normalizedTitle);
-	if (existing !== void 0 && existing.status !== "provisional") throw new Error("new-domain-conflict");
-	const id = existing?.id ?? mintDomainId(proposed.title);
-	if (current.domains.some((node) => node.id !== id && node.triggers.some((trigger) => proposed.triggers.includes(trigger)))) throw new Error("new-domain-conflict");
-	const domain = existing ?? {
-		id,
-		name: proposed.title,
-		purpose: proposed.purpose,
-		description: proposed.purpose,
-		inScope: proposed.inScope,
-		outOfScope: proposed.outOfScope,
-		triggers: proposed.triggers,
-		parentIds: [],
-		status: "provisional",
-		version: 1,
-		createdAt: entry.createdAt,
-		updatedAt: entry.createdAt,
-		descriptionHash: "pending",
-		descriptionVersion: 1,
-		descriptionStatus: "fresh",
-		provenance: { source: "create" },
-		quality: {}
-	};
-	const members = new Set(current.edges.filter((item) => item.domainId === id).map((item) => item.skillKey));
-	members.add(entry.submission.skillKey);
-	const promote = members.size >= threshold;
-	const finalDomain = promote ? {
-		...domain,
-		status: "active",
-		updatedAt: entry.createdAt
-	} : domain;
-	return {
-		mapVersion: nextMapVersion$1(current.mapVersion),
-		domains: existing === void 0 ? [...current.domains, finalDomain] : current.domains.map((node) => node.id === id ? finalDomain : node),
-		edges: [
-			...current.edges,
-			{
-				...edge,
-				domainId: id
-			},
-			...secondaries.filter((secondary) => secondary.domainId !== id)
-		],
-		provisional: !promote
-	};
-}
-//#endregion
-//#region lib/types/assignment-queue.js
-const COLLECTION = "assignment-queue";
-/** Durable assignment queue; process-local cache over one JSON file. */
-var JsonAssignmentQueue = class {
-	entries = /* @__PURE__ */ new Map();
-	loadPromise;
-	io;
-	path;
-	store;
-	constructor(io, path, store) {
-		this.io = io;
-		this.path = path;
-		this.store = store;
-	}
-	load() {
-		this.loadPromise ??= (async () => {
-			if (this.store !== void 0) {
-				for (const entry of await this.store.list(COLLECTION)) this.entries.set(entry.key, entry);
-				if (this.entries.size > 0) return;
-			}
-			const content = await this.io.readText(this.path);
-			if (content === null) return;
-			try {
-				const parsed = JSON.parse(content);
-				if (parsed.schemaVersion !== 1 || !Array.isArray(parsed.entries)) return;
-				for (const entry of parsed.entries) {
-					this.entries.set(entry.key, entry);
-					if (this.store !== void 0) await this.store.transact(COLLECTION, entry.key, async () => entry);
-				}
-			} catch {}
-		})();
-		return this.loadPromise;
-	}
-	async persist() {
-		if (this.store === void 0) await this.io.writeText(this.path, JSON.stringify({
-			schemaVersion: 1,
-			entries: [...this.entries.values()]
-		}));
-	}
-	async enqueue(input) {
-		await this.load();
-		const existing = this.entries.get(input.key);
-		if (existing !== void 0) return {
-			entry: existing,
-			duplicate: true
-		};
-		const entry = {
-			...input,
-			status: "queued"
-		};
-		if (this.store !== void 0) {
-			let duplicate = false;
-			let stored = entry;
-			await this.store.transact(COLLECTION, input.key, async (current) => {
-				if (current !== void 0) {
-					duplicate = true;
-					stored = current;
-					return current;
-				}
-				return entry;
-			});
-			this.entries.set(input.key, stored);
-			return {
-				entry: stored,
-				duplicate
-			};
-		}
-		this.entries.set(input.key, entry);
-		await this.persist();
-		return {
-			entry,
-			duplicate: false
-		};
-	}
-	async update(key, status, pendingReason) {
-		await this.load();
-		const entry = this.entries.get(key);
-		if (entry === void 0) return;
-		const nextEntry = {
-			...entry,
-			status,
-			pendingReason
-		};
-		if (this.store !== void 0) await this.store.transact(COLLECTION, key, async (current) => current === void 0 ? nextEntry : {
-			...current,
-			status,
-			pendingReason
-		});
-		this.entries.set(key, nextEntry);
-		await this.persist();
-	}
-	list() {
-		return [...this.entries.values()];
-	}
-};
-//#endregion
-//#region lib/types/worker.js
-/** Drivable worker; the composition may call drain on a schedule. */
-var AssignmentWorker = class {
-	service;
-	queue;
-	constructor(service, queue) {
-		this.service = service;
-		this.queue = queue;
-	}
-	/** Process queued entries once; returns processed count. */
-	async drain(limit = 10) {
-		const entries = this.queue.list().filter((entry) => entry.status === "queued").slice(0, Math.max(0, limit));
-		for (const entry of entries) await this.service.process(entry);
-		return entries.length;
-	}
-};
-//#endregion
-//#region lib/types/assignment-sidecar.js
-function submitCreate(service, args, options) {
-	if (typeof args.name !== "string" || args.name.length === 0) return void 0;
-	const parsed = parseFrontmatter(typeof args.content === "string" ? args.content : "");
-	const description = parsed?.frontmatter.description ?? "";
-	const rawWhenToUse = parsed?.frontmatter.whenToUse;
-	const whenToUse = typeof rawWhenToUse === "string" ? rawWhenToUse : void 0;
-	const domain = args.domain;
-	const proposal = typeof domain === "object" && domain !== null ? domain : void 0;
-	return service.submit({
-		skillKey: skillKeyOf({
-			provider: options.provider ?? "dsh-evolution",
-			source: options.source ?? "user-dsh",
-			name: args.name
-		}),
-		threeFieldHash: threeFieldHashOf({
-			name: args.name,
-			description,
-			...whenToUse === void 0 ? {} : { whenToUse }
-		}),
-		modelInvocable: parsed?.frontmatter["disable-model-invocation"] !== true,
-		...whenToUse === void 0 ? {} : { whenToUse },
-		...proposal === void 0 ? {} : { proposal }
-	}).then(() => options.onSubmitted?.());
-}
-/**
-* Observe successful create calls and submit their optional domain proposal.
-* Direct creates submit immediately; staged creates submit only after approval.
-* @param ctx - plugin context with tools and approval events.
-* @param service - the one assignment service.
-* @param options - provider/source identity for skillKey.
-* @returns disposer for both listeners.
-*/
-function installAssignmentSidecar(ctx, service, options = {}) {
-	const stopResult = ctx.on("tools/result", (exec, result) => {
-		if (result.isError || exec.name !== "skill_manage" || exec.agent === void 0) return;
-		if (result.value?.pending_id !== void 0) return;
-		const args = exec.arguments;
-		if (typeof args !== "object" || args === null) return;
-		const record = args;
-		if (record.action !== "create") return;
-		submitCreate(service, record, options)?.catch(() => {});
-	});
-	const stopApproval = ctx.on("evolution/approval-decided", ({ record, action, ok }) => {
-		if (!ok || action !== "approve" || record.kind !== "skill" || typeof record.args !== "object" || record.args === null) return;
-		const raw = record.args;
-		const operation = typeof raw.operation === "object" && raw.operation !== null ? raw.operation : raw;
-		if (operation.action !== "create") return;
-		submitCreate(service, operation, options)?.catch(() => {});
-	});
-	return () => {
-		stopResult();
-		stopApproval();
-	};
-}
-//#endregion
 //#region lib/types/awareness.js
 /** Static 1–2 sentence awareness; no domain list/tree. */
 const DISCOVERY_AWARENESS = "When skill coverage for a task is uncertain, the domain cards and skill_search can reduce it; search is optional, not a required step.";
@@ -2586,57 +2138,45 @@ function renderDomainDescription(domain) {
 }
 //#endregion
 //#region lib/types/description-refresh.js
-function nextMapVersion(version) {
-	const numeric = Number(version);
-	return Number.isSafeInteger(numeric) && numeric >= 0 ? String(numeric + 1) : version + ".1";
-}
 /**
-* Mark aged fresh descriptions stale so the refresh pass has a producer.
+* Mark aged descriptions stale AND refresh every stale description in ONE
+* read/commit. Session start used to call the two producers back to back, so a
+* single start bumped mapVersion twice (P2-14).
 * @param store - domain map store.
 * @param maxAgeHours - age threshold; undefined disables the producer.
 * @param now - clock for deterministic tests.
-* @returns number of domains marked stale.
+* @returns counts of marked and refreshed domains.
 */
-async function markStaleDescriptions(store, maxAgeHours, now = Date.now()) {
-	if (maxAgeHours === void 0 || maxAgeHours < 0) return 0;
-	const snapshot = await store.read();
-	const aged = snapshot.domains.filter((node) => node.descriptionStatus === "fresh" && node.updatedAt > 0 && now - node.updatedAt > maxAgeHours * 36e5);
-	if (aged.length === 0) return 0;
-	const domains = snapshot.domains.map((node) => aged.includes(node) ? {
-		...node,
-		descriptionStatus: "stale"
-	} : node);
-	await store.commit(snapshot.mapVersion, {
-		mapVersion: nextMapVersion(snapshot.mapVersion),
-		domains,
-		edges: snapshot.edges
-	});
-	return aged.length;
-}
-/**
-* Re-render stale domain descriptions from their definition fields.
-* @param store - domain map store.
-* @returns number of refreshed domains.
-*/
-async function refreshStaleDescriptions(store) {
+async function refreshAgedDescriptions(store, maxAgeHours, now = Date.now()) {
+	if (maxAgeHours === void 0 || maxAgeHours < 0) return {
+		marked: 0,
+		refreshed: 0
+	};
 	const snapshot = await store.read();
-	const stale = snapshot.domains.filter((node) => node.descriptionStatus === "stale");
-	if (stale.length === 0) return 0;
-	const now = Date.now();
-	const domains = snapshot.domains.map((node) => node.descriptionStatus !== "stale" ? node : {
+	const aged = new Set(snapshot.domains.filter((node) => node.descriptionStatus === "fresh" && (node.descriptionUpdatedAt ?? node.updatedAt) > 0 && now - (node.descriptionUpdatedAt ?? node.updatedAt) > maxAgeHours * 36e5).map((node) => node.id));
+	const stale = snapshot.domains.filter((node) => node.descriptionStatus === "stale" || aged.has(node.id));
+	if (stale.length === 0) return {
+		marked: 0,
+		refreshed: 0
+	};
+	const staleIds = new Set(stale.map((node) => node.id));
+	const domains = snapshot.domains.map((node) => !staleIds.has(node.id) ? node : {
 		...node,
 		description: renderDomainDescription(node),
 		descriptionHash: descriptionHashOf(node, snapshot.domains.filter((child) => child.parentIds.includes(node.id))),
 		descriptionVersion: node.descriptionVersion + 1,
 		descriptionStatus: "fresh",
-		updatedAt: now
+		descriptionUpdatedAt: now
 	});
 	await store.commit(snapshot.mapVersion, {
 		mapVersion: nextMapVersion(snapshot.mapVersion),
 		domains,
 		edges: snapshot.edges
 	});
-	return stale.length;
+	return {
+		marked: aged.size,
+		refreshed: stale.length
+	};
 }
 //#endregion
 //#region lib/types/main-entry.js
@@ -2788,7 +2328,7 @@ function apply(ctx, config) {
 	const journal = new ProjectionJournal(io, config.projectionJournalPath ?? join(root, "evolution", "projection-journal.json"));
 	const snapshots = new ViewSnapshotStore(io, config.viewSnapshotPath ?? join(root, "evolution", "view-snapshots.json"));
 	const globalPolicy = {
-		mode: mode === "shadow" ? "auto" : mode,
+		mode,
 		pinDomains: config.pinDomains,
 		disableDomains: config.disableDomains
 	};
@@ -2825,6 +2365,7 @@ function apply(ctx, config) {
 		journal,
 		workingDirectory,
 		history: (agent) => projections?.stateOf(agent.session, "evolutionProjectionHistory"),
+		warn: (message) => ctx.logger.warn(message),
 		featureEpoch: config.featureEpoch,
 		codecVersion: "1",
 		adapterVersion: "1",
@@ -2837,21 +2378,6 @@ function apply(ctx, config) {
 		descriptionStaleAfterHours,
 		isFrozen: async (agent) => snapshots.isFrozen(String(agent.session.id), config.featureEpoch)
 	});
-	const queue = new JsonAssignmentQueue(io, config.assignmentQueuePath ?? join(root, "evolution", "assignment-queue.json"), ctx.get("evolutionStateStore"));
-	const assignment = new DomainAssignmentService(queue, map, {
-		createClassificationEnabled: config.createClassificationEnabled ?? false,
-		...config.provisionalThreshold === void 0 ? {} : { provisionalThreshold: config.provisionalThreshold },
-		now: Date.now
-	});
-	const worker = new AssignmentWorker(assignment, queue);
-	queue.load().then(() => worker.drain()).catch(() => {
-		ctx.logger.warn("evolution-skill-discovery: assignment queue load failed; queued work stays for the next start");
-	});
-	installAssignmentSidecar(ctx, assignment, { onSubmitted: () => {
-		worker.drain().catch((error) => {
-			ctx.logger.warn("evolution-skill-discovery: assignment drain failed: " + (error instanceof Error ? error.message : String(error)));
-		});
-	} });
 	ctx.on("agent/created", async ({ agent, source: start }) => {
 		try {
 			installDiscoveryAwareness(agent.ctx);
@@ -2876,10 +2402,9 @@ function apply(ctx, config) {
 				featureEpoch: config.featureEpoch,
 				createdAt: Date.now()
 			});
-			const marked = await markStaleDescriptions(map, descriptionStaleAfterHours);
-			if (marked > 0) ctx.logger.info("evolution-skill-discovery: marked " + marked + " aged domain descriptions stale");
-			const refreshed = await refreshStaleDescriptions(map);
-			if (refreshed > 0) ctx.logger.info("evolution-skill-discovery: refreshed " + refreshed + " stale domain descriptions");
+			const aged = await refreshAgedDescriptions(map, descriptionStaleAfterHours);
+			if (aged.marked > 0) ctx.logger.info("evolution-skill-discovery: marked " + aged.marked + " aged domain descriptions stale");
+			if (aged.refreshed > 0) ctx.logger.info("evolution-skill-discovery: refreshed " + aged.refreshed + " stale domain descriptions");
 		} catch (error) {
 			ctx.logger.warn("evolution-skill-discovery: initial view snapshot failed: " + (error instanceof Error ? error.message : String(error)));
 		}
@@ -2915,23 +2440,9 @@ function apply(ctx, config) {
 					text: "discovery mode=" + mode + "; view=" + view.viewKey + "; phase=" + state.phase + " map=" + state.map + " search=" + state.search + " policy=" + state.policy + " last=" + report.action + (state.reasons.length === 0 ? "" : " reasons=" + state.reasons.join(",")) + "\n" + rows.join("\n")
 				};
 			}
-			if (action === "confirm") {
-				const domainId = rawInput.trim().split(/\s+/)[1];
-				if (domainId === void 0) return {
-					kind: "error",
-					text: "Usage: /skill-domain confirm <id>"
-				};
-				return await assignment.confirm(domainId) ? {
-					kind: "success",
-					text: "Confirmed domain " + domainId + "."
-				} : {
-					kind: "error",
-					text: "Unknown or non-provisional domain: " + domainId
-				};
-			}
 			if (action !== "generate") return {
 				kind: "error",
-				text: "Usage: /skill-domain status | generate | confirm <id>"
+				text: "Usage: /skill-domain status | generate"
 			};
 			if (coordinator === void 0) return {
 				kind: "error",