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

package/lib/main-entry.js

@@ -1,6 +1,6 @@
 import { isAbsolute, join, resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
-import { authorityFrom, evolutionIoAdapter, evolutionRoot, isRecord, makeSerialQueue, newSkillLibrary, parseFrontmatter } from "@lmzhen/dsh-evolution-core";
+import { authorityFrom, evolutionIoAdapter, evolutionRoot, installEvolutionProjections, isRecord, makeSerialQueue, newSkillLibrary, parseFrontmatter } from "@lmzhen/dsh-evolution-core";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { escapeText } from "@deepseek-ai/dsh-skill";
 import MiniSearch from "minisearch";
@@ -661,6 +661,18 @@ var ProjectionJournal = class {
 			await this.io.writeText(this.path, JSON.stringify(this.cache));
 		});
 	}
+	/** Delete every record for one session/view after a successful restore. */
+	async removeView(sessionId, viewKey, _codecVersion) {
+		await this.serial(async () => {
+			const current = await this.read();
+			const records = Object.fromEntries(Object.entries(current.records).filter(([, record]) => record.sessionId !== sessionId || record.viewKey !== viewKey));
+			this.cache = {
+				schemaVersion: 1,
+				records
+			};
+			await this.io.writeText(this.path, JSON.stringify(this.cache));
+		});
+	}
 };
 //#endregion
 //#region lib/types/domain-quality.js
@@ -1100,8 +1112,9 @@ function restoreCapturedProjection(decision, capture) {
 * @param result - projection result.
 * @returns decision with replacement catalog plus optional context.
 */
-function applyReplacementDecision(decision, sourceEntries, result) {
+function applyReplacementDecision(decision, sourceEntries, result, seen) {
 	if (decision.kind !== "enter") return decision;
+	if (seen?.has(result.digest) === true) return decision;
 	const update = renderCatalogUpdate(sourceEntries, result.catalogEntries);
 	const context = renderProjectionContext(result);
 	const messages = context === void 0 ? [...decision.messages, update] : [
@@ -1155,11 +1168,11 @@ function renderProjectionContext(result) {
 * @param result - complete projection.
 * @returns new decision; unchanged when no catalog exists.
 */
-function applyProjectedDecision(decision, capture, result) {
+function applyProjectedDecision(decision, capture, result, seen) {
 	const withCatalog = applyCapturedProjection(decision, capture, result.catalogEntries);
 	const context = renderProjectionContext(result);
 	if (context === void 0 || withCatalog.kind !== "enter") return withCatalog;
-	return withCatalog.messages.some((message) => message.source.kind === "evolution-skill-projection" && message.source.digest === result.digest) ? withCatalog : {
+	return withCatalog.messages.some((message) => message.source.kind === "evolution-skill-projection" && message.source.digest === result.digest) || seen?.has(result.digest) === true ? withCatalog : {
 		...withCatalog,
 		messages: [...withCatalog.messages, context]
 	};
@@ -1269,9 +1282,36 @@ function catalogText(message) {
 function fullCatalogText(capture) {
 	return catalogText(renderCatalog(capture, capture.entries));
 }
-function sessionCatalogCapture(agent) {
+function captureOfFrame(frame) {
+	return {
+		text: frame.text,
+		source: {
+			kind: "skill-catalog",
+			form: "catalog",
+			...frame.update ? { update: true } : {},
+			entries: frame.entries
+		},
+		entries: frame.entries,
+		update: frame.update
+	};
+}
+function sessionCatalogCapture(agent, history) {
+	if (history !== void 0 && history.catalogs.length > 0) {
+		let full;
+		let projected;
+		for (const frame of history.catalogs) {
+			const capture = captureOfFrame(frame);
+			projected = capture;
+			if (catalogText({ content: [{
+				type: "text",
+				text: frame.text
+			}] }) === fullCatalogText(capture)) full = capture;
+		}
+		return full ?? projected;
+	}
 	const readEvents = agent.session.readEvents;
 	if (readEvents === void 0) return void 0;
+	let full;
 	let projected;
 	for (const event of readEvents()) {
 		if (event.type !== "user/message" || typeof event.data !== "object" || event.data === null) continue;
@@ -1280,9 +1320,27 @@ function sessionCatalogCapture(agent) {
 		const capture = captureCatalog(message);
 		if (capture === void 0) continue;
 		projected = capture;
-		if (catalogText(message) === fullCatalogText(capture)) return capture;
+		if (catalogText(message) === fullCatalogText(capture)) full = capture;
 	}
-	return projected;
+	return full ?? projected;
+}
+/** The full platform catalog carried by a (possibly projected) capture. */
+function fullCaptureOf(capture) {
+	return captureCatalog(renderCatalog(capture, capture.entries));
+}
+/** Digest of every projection context already present in session history. */
+function sessionProjectionDigests(agent, history) {
+	const digests = new Set(history?.digests ?? []);
+	const readEvents = agent.session.readEvents;
+	if (readEvents === void 0) return digests;
+	for (const event of readEvents()) {
+		if (event.type !== "user/message" || typeof event.data !== "object" || event.data === null) continue;
+		const message = event.data;
+		if (message.source.kind !== "evolution-skill-projection") continue;
+		const digest = message.source.digest;
+		if (typeof digest === "string") digests.add(digest);
+	}
+	return digests;
 }
 /** Per-view projection runtime; no global readiness and no history edits. */
 var ProjectionRuntime = class {
@@ -1317,9 +1375,12 @@ var ProjectionRuntime = class {
 	}
 	async restore(agent, viewKey, decision, currentCapture) {
 		const record = await this.ports.journal.latest(String(agent.id), viewKey, this.ports.codecVersion);
-		const sessionBase = sessionCatalogCapture(agent);
-		const fullSession = sessionBase !== void 0 && sessionBase.text === fullCatalogText(sessionBase) ? sessionBase : void 0;
-		const durable = currentCapture !== void 0 && currentCapture.text !== fullCatalogText(currentCapture) ? fullSession ?? record?.base : currentCapture ?? fullSession ?? record?.base;
+		const history = this.ports.history?.(agent);
+		const sessionBase = sessionCatalogCapture(agent, history);
+		const fullSession = sessionBase === void 0 ? void 0 : sessionBase.text === fullCatalogText(sessionBase) ? sessionBase : fullCaptureOf(sessionBase);
+		const projectedCurrent = currentCapture !== void 0 && currentCapture.text !== fullCatalogText(currentCapture);
+		const fullCurrent = currentCapture === void 0 ? void 0 : fullCaptureOf(currentCapture);
+		const durable = projectedCurrent ? record?.base ?? fullSession ?? fullCurrent : fullCurrent ?? fullSession ?? record?.base;
 		if (durable === void 0) {
 			this.mark(agent, "blocked", "");
 			return decision;
@@ -1328,7 +1389,7 @@ var ProjectionRuntime = class {
 		const previous = this.report(agent);
 		if (previous.action === "restored" && previous.content === fullText) return decision;
 		const restored = currentCapture === void 0 ? applyRestoreUpdate(decision, durable) : restoreCapturedProjection(decision, durable);
-		if (record !== void 0) await this.ports.journal.remove(record.sessionId, record.viewKey, record.projectionDigest, record.codecVersion);
+		await this.ports.journal.removeView(String(agent.id), viewKey, this.ports.codecVersion);
 		this.mark(agent, "restored", record?.projectionDigest ?? "", fullText);
 		return restored;
 	}
@@ -1398,9 +1459,18 @@ var ProjectionRuntime = class {
 		if (this.ports.isFrozen !== void 0 && await this.ports.isFrozen(agent)) return decision;
 		const { view, snapshot, policy, policyDigest, state } = await this.readState(agent, signal);
 		const currentCapture = captureDecisionCatalog(decision);
+		const history = this.ports.history?.(agent);
+		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;
+			const digest = message.source.digest;
+			if (typeof digest === "string") seen.add(digest);
+		}
+		const previous = this.report(agent);
+		if (previous.action === "applied" && previous.digest !== "") seen.add(previous.digest);
 		let capture = currentCapture;
 		if (capture === void 0) capture = (await this.ports.journal.latest(String(agent.id), view.viewKey, this.ports.codecVersion))?.base;
-		if (capture === void 0) capture = sessionCatalogCapture(agent);
+		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) {
 			this.mark(agent, "blocked", "");
@@ -1431,8 +1501,8 @@ var ProjectionRuntime = class {
 		});
 		if (!projection.complete) return this.restore(agent, view.viewKey, decision, currentCapture);
 		const expectedText = renderCatalog(capture, projection.catalogEntries).content.map((block) => block.type === "text" ? block.text : "").join("");
-		if (currentCapture !== void 0 && currentCapture.text === expectedText) return decision;
-		const previous = this.report(agent);
+		if (currentCapture !== void 0 && currentCapture.text === expectedText) return seen.has(projection.digest) ? decision : applyProjectedDecision(decision, currentCapture, projection, seen);
+		if (currentCapture === void 0 && seen.has(projection.digest)) return decision;
 		if (currentCapture === void 0 && previous.action === "applied" && previous.digest === projection.digest && previous.content === expectedText) return decision;
 		await this.ports.journal.put({
 			sessionId: String(agent.id),
@@ -1445,7 +1515,7 @@ var ProjectionRuntime = class {
 			createdAt: Date.now()
 		});
 		this.mark(agent, "applied", projection.digest, expectedText);
-		return currentCapture === void 0 ? applyReplacementDecision(decision, capture.source.entries, projection) : applyProjectedDecision(decision, capture, projection);
+		return currentCapture === void 0 ? applyReplacementDecision(decision, capture.source.entries, projection, seen) : applyProjectedDecision(decision, capture, projection, seen);
 	}
 };
 //#endregion
@@ -2521,6 +2591,29 @@ function nextMapVersion(version) {
 	return Number.isSafeInteger(numeric) && numeric >= 0 ? String(numeric + 1) : version + ".1";
 }
 /**
+* Mark aged fresh descriptions stale so the refresh pass has a producer.
+* @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.
+*/
+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.
@@ -2604,6 +2697,7 @@ function searchUnavailable() {
 }
 /** Apply the full production discovery composition. */
 function apply(ctx, config) {
+	installEvolutionProjections(ctx);
 	if (typeof config.featureEpoch !== "string" || config.featureEpoch.length === 0) throw new Error("evolution-skill-discovery: featureEpoch is required");
 	const evolutionIo = ctx.evolutionIo;
 	const io = evolutionIoAdapter(() => evolutionIo.provider());
@@ -2629,7 +2723,7 @@ function apply(ctx, config) {
 		...config.generationAttempts === void 0 ? {} : { attempts: config.generationAttempts }
 	});
 	const searchCache = new SkillSearchCache();
-	let searchHealthy = true;
+	let searchHealthy = false;
 	const search = {
 		async allowedSkillKeys(agent, signal) {
 			if (mode === "off" || agent === void 0) return void 0;
@@ -2690,6 +2784,7 @@ function apply(ctx, config) {
 	});
 	if (mode === "off") return;
 	const map = new DomainMapFileStore(io, config.domainMapPath ?? join(root, "evolution", "domain-map.json"));
+	const descriptionStaleAfterHours = config.descriptionStaleAfterHours ?? 168;
 	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 = {
@@ -2721,6 +2816,7 @@ function apply(ctx, config) {
 			...scope === void 0 ? {} : { scope }
 		});
 	};
+	const projections = ctx.get("sessionProjections");
 	const runtime = new ProjectionRuntime({
 		skillIndexSource: source,
 		map,
@@ -2728,6 +2824,7 @@ function apply(ctx, config) {
 		policyFor,
 		journal,
 		workingDirectory,
+		history: (agent) => projections?.stateOf(agent.session, "evolutionProjectionHistory"),
 		featureEpoch: config.featureEpoch,
 		codecVersion: "1",
 		adapterVersion: "1",
@@ -2737,7 +2834,7 @@ function apply(ctx, config) {
 		...config.tokenBudget === void 0 ? {} : { tokenBudget: config.tokenBudget },
 		searchAvailable: () => searchHealthy && config.searchEnabled !== false,
 		...config.staleAfterHours === void 0 ? {} : { staleAfterHours: config.staleAfterHours },
-		...config.descriptionStaleAfterHours === void 0 ? {} : { descriptionStaleAfterHours: config.descriptionStaleAfterHours },
+		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"));
@@ -2779,6 +2876,8 @@ 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");
 		} catch (error) {

package/lib/types/description-refresh.d.ts

@@ -1,4 +1,12 @@
 import type { DomainMapStore } from './domain-map.ts';
+/**
+ * Mark aged fresh descriptions stale so the refresh pass has a producer.
+ * @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.
+ */
+export declare function markStaleDescriptions(store: DomainMapStore, maxAgeHours: number | undefined, now?: number): Promise<number>;
 /**
  * Re-render stale domain descriptions from their definition fields.
  * @param store - domain map store.

package/lib/types/index.d.ts

@@ -18,6 +18,7 @@ export * from './domain-map-store.ts';
 export * from './domain-policy.ts';
 export * from './domain-generation.ts';
 export * from './domain-description.ts';
+export * from './description-refresh.ts';
 export * from './domain-quality.ts';
 export * from './domain-projection.ts';
 export * from './tool.ts';

package/lib/types/projection-adapter.d.ts

@@ -37,7 +37,7 @@ export declare function restoreCapturedProjection(decision: PreStepDecision, cap
  * @param result - projection result.
  * @returns decision with replacement catalog plus optional context.
  */
-export declare function applyReplacementDecision(decision: PreStepDecision, sourceEntries: readonly CatalogEntry[], result: ProjectionResult): PreStepDecision;
+export declare function applyReplacementDecision(decision: PreStepDecision, sourceEntries: readonly CatalogEntry[], result: ProjectionResult, seen?: ReadonlySet<string> | undefined): PreStepDecision;
 /**
  * Append a full replacement catalog without a current catalog message.
  * @param decision - current pre-step decision.
@@ -56,5 +56,5 @@ export declare function renderProjectionContext(result: ProjectionResult): UserM
  * @param result - complete projection.
  * @returns new decision; unchanged when no catalog exists.
  */
-export declare function applyProjectedDecision(decision: PreStepDecision, capture: CatalogCapture, result: ProjectionResult): PreStepDecision;
+export declare function applyProjectedDecision(decision: PreStepDecision, capture: CatalogCapture, result: ProjectionResult, seen?: ReadonlySet<string> | undefined): PreStepDecision;
 //# sourceMappingURL=projection-adapter.d.ts.map

package/lib/types/projection-journal.d.ts

@@ -30,5 +30,7 @@ export declare class ProjectionJournal {
     latest(sessionId: string, viewKey: string, codecVersion: string): Promise<ProjectionJournalRecord | undefined>;
     /** Delete one record after a successful restore. */
     remove(sessionId: string, viewKey: string, projectionDigest: string, codecVersion: string): Promise<void>;
+    /** Delete every record for one session/view after a successful restore. */
+    removeView(sessionId: string, viewKey: string, _codecVersion: string): Promise<void>;
 }
 //# sourceMappingURL=projection-journal.d.ts.map

package/lib/types/projection-runtime.d.ts

@@ -8,6 +8,18 @@ import { type ViewState } from './view-state.ts';
 export interface WorkingDirectoryPort {
     ensure(agent: Agent, signal?: AbortSignal | undefined): Promise<string>;
 }
+/** Bounded catalog/projection history from the evolution-core projection unit. */
+export interface ProjectionHistoryView {
+    readonly catalogs: readonly {
+        readonly text: string;
+        readonly entries: readonly {
+            readonly name: string;
+            readonly description: string;
+        }[];
+        readonly update: boolean;
+    }[];
+    readonly digests: readonly string[];
+}
 /** Inputs for the per-view projection runtime. */
 export interface ProjectionRuntimePorts {
     readonly skillIndexSource: SkillIndexSource;
@@ -16,6 +28,7 @@ export interface ProjectionRuntimePorts {
     readonly policyFor?: ((cwd: string) => Promise<DomainPolicyStore>) | undefined;
     readonly journal: ProjectionJournal;
     readonly workingDirectory: WorkingDirectoryPort;
+    readonly history?: ((agent: Agent) => ProjectionHistoryView | undefined) | undefined;
     readonly featureEpoch: string;
     readonly codecVersion: string;
     readonly adapterVersion: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-skill-discovery",
   "description": "Read model and view identity for evolution skill discovery (community build)",
-  "version": "0.32.1",
+  "version": "0.32.3",
   "publishConfig": {
     "access": "public"
   },
@@ -32,9 +32,9 @@
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-contract": "^0.32.1",
-    "@lmzhen/dsh-evolution-core": "^0.32.1",
-    "@lmzhen/dsh-evolution-io": "^0.32.1"
+    "@lmzhen/dsh-evolution-contract": "^0.32.3",
+    "@lmzhen/dsh-evolution-core": "^0.32.3",
+    "@lmzhen/dsh-evolution-io": "^0.32.3"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-skill": "^0.2.1-rc.2",
@@ -44,9 +44,9 @@
     "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-contract": "^0.32.1",
-    "@lmzhen/dsh-evolution-core": "^0.32.1",
-    "@lmzhen/dsh-evolution-io": "^0.32.1"
+    "@lmzhen/dsh-evolution-contract": "^0.32.3",
+    "@lmzhen/dsh-evolution-core": "^0.32.3",
+    "@lmzhen/dsh-evolution-io": "^0.32.3"
   },
   "dependencies": {
     "@deepseek-ai/dsh-llm": "^0.2.1-rc.2",