@lmzhen/dsh-evolution-core 0.1.0-rc.50 → 0.1.0-rc.52

package/lib/index.js

@@ -2,14 +2,12 @@ import { basename, dirname, join } from "node:path";
 import { cp, lstat, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { createHash, randomBytes } from "node:crypto";
 import { homedir } from "node:os";
-import { readFileSync } from "node:fs";
 //#region lib/types/io.js
 /**
-* Structural IO seam for the legacy facade stores.
+* Structural IO seam for the evolution plugin family.
 *
-* The facade accepts any object exposing this small async file-tree surface.
-* Native DSH packages pass `ctx.evolutionIo.provider()`; standalone consumers
-* (and the facade's own tests) can use `nodeEvolutionIo`.
+* Every evolution package passes `ctx.evolutionIo.provider()`; standalone
+* consumers (and the core's own tests) can use `nodeEvolutionIo`.
 */
 /**
 * Run `task` inside `io.transact` when the backend provides it; otherwise fall
@@ -1326,84 +1324,6 @@ var MemoryStore = class {
 			limit: this.limitFor(target)
 		};
 	}
-	async replace(target, oldText, facts) {
-		return this.mutate(target, oldText, "replace", facts);
-	}
-	async remove(target, oldText) {
-		return this.mutate(target, oldText, "remove", void 0);
-	}
-	async mutate(target, oldText, action, facts) {
-		const needle = oldText.trim();
-		if (!needle) {
-			const current = await this.read(target);
-			return {
-				ok: false,
-				message: `old_text cannot be empty.${previewEntries(current)}`,
-				entries: current,
-				chars: current.join(ENTRY_DELIMITER).length,
-				limit: this.limitFor(target)
-			};
-		}
-		const refusal = await this.oversizedRefusal(target);
-		if (refusal) return refusal;
-		const content = action === "replace" ? (facts ?? "").trim() : "";
-		if (action === "replace" && !content) return {
-			ok: false,
-			message: "facts is required for replace; use remove to delete.",
-			entries: [],
-			chars: 0,
-			limit: this.limitFor(target)
-		};
-		if (action === "replace") {
-			const threat = scanMemoryThreats(content);
-			if (threat) return {
-				ok: false,
-				message: threat,
-				entries: [],
-				chars: 0,
-				limit: this.limitFor(target)
-			};
-		}
-		if (await this.detectDrift(target)) {
-			const backup = await this.backupFile(target);
-			return {
-				ok: false,
-				message: `External drift detected in memory file.${backup ? ` A backup was saved to ${basename(backup)}.` : ""} Resolve the drift before retrying.`,
-				entries: [],
-				chars: 0,
-				limit: this.limitFor(target)
-			};
-		}
-		const entries = await this.read(target);
-		const matches = entries.map((entry, index) => ({
-			entry,
-			index
-		})).filter(({ entry }) => entry.includes(needle));
-		if (matches.length === 0) return this.failure(target, `No entry matching "${needle}" found.`, entries);
-		if (new Set(matches.map((m) => m.entry)).size > 1) return {
-			ok: false,
-			message: `Multiple distinct entries matched "${needle}". Be more specific.`,
-			entries,
-			chars: entries.join(ENTRY_DELIMITER).length,
-			limit: this.limitFor(target)
-		};
-		const index = matches[0]?.index ?? -1;
-		const next = [...entries];
-		if (action === "remove") next.splice(index, 1);
-		else next[index] = content;
-		const total = next.join(ENTRY_DELIMITER).length;
-		const mutateLimit = this.limitFor(target);
-		if (mutateLimit > 0 && total > mutateLimit) return this.failure(target, `Resulting memory would exceed the ${mutateLimit} char limit.`, entries);
-		await this.write(target, next);
-		this.resetFailures();
-		return {
-			ok: true,
-			message: `Entry ${action === "remove" ? "removed" : "replaced"}.${this.storageHint(target, total)}`,
-			entries: next,
-			chars: total,
-			limit: this.limitFor(target)
-		};
-	}
 	async applyBatch(target, operations) {
 		if (operations.length === 0) return {
 			ok: false,
@@ -2796,67 +2716,11 @@ var SkillLibrary = class {
 //#endregion
 //#region lib/types/state-store.js
 /**
-* Small crash-safe JSON state store for plugin-owned sidecar state.
-* Writes are atomic (temp + rename). Reads are synchronous for startup use.
+* Evolution home path helper: `$DSH_HOME/evolution` for plugin-owned sidecar
+* state (reports, activity store, feedback file, state-domain data).
 */
 function evolutionHome(env = process.env) {
 	return join(env.DSH_HOME ?? join(homedir(), ".dsh"), "evolution");
 }
-var JsonState = class JsonState {
-	initial;
-	path;
-	value;
-	constructor(name, initial, env = process.env) {
-		this.initial = initial;
-		this.path = join(evolutionHome(env), name);
-		this.value = this.loadSync();
-	}
-	/**
-	* Deep-merge persisted state over the initial defaults. Nested plain
-	* objects merge recursively (so a new default field added under an existing
-	* object is preserved), while arrays and primitives take the on-disk value
-	* wholesale. Keeps forward-compatible defaults across schema additions.
-	*/
-	static mergeDeep(initial, persisted) {
-		const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-		if (!isRecord(initial) || !isRecord(persisted)) return isRecord(persisted) ? persisted : persisted == null ? initial : persisted;
-		const out = { ...initial };
-		for (const [key, value] of Object.entries(persisted)) out[key] = key in initial ? JsonState.mergeDeep(initial[key], value) : value;
-		return out;
-	}
-	loadSync() {
-		try {
-			const raw = readFileSync(this.path, "utf8");
-			const parsed = JSON.parse(raw);
-			return JsonState.mergeDeep(this.initial, parsed);
-		} catch {
-			return { ...this.initial };
-		}
-	}
-	get() {
-		return this.value;
-	}
-	set(value) {
-		this.value = value;
-	}
-	update(mutator) {
-		mutator(this.value);
-	}
-	async flush() {
-		await mkdir(dirname(this.path), { recursive: true });
-		const tmp = `${this.path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
-		await writeFile(tmp, JSON.stringify(this.value, null, 2), "utf8");
-		await rename(tmp, this.path);
-	}
-	/** Merge-on-load helper for persisted maps/records. */
-	async reload() {
-		try {
-			const raw = await readFile(this.path, "utf8");
-			this.value = JsonState.mergeDeep(this.initial, JSON.parse(raw));
-		} catch {
-			this.value = { ...this.initial };
-		}
-	}
-};
 //#endregion
-export { COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_USER_CHAR_LIMIT, DSH_AUTHORING_STANDARDS, ENTRY_DELIMITER, EvolutionGateSet, JsonState, LOW_QUALITY_THRESHOLD, MAX_DESCRIPTION_LENGTH, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MEMORY_REVIEW_PROMPT, MUTATIONS_FILE_VERSION, MemoryStore, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, QUALITY_WEIGHTS, SKILL_NAME_RE, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, advanceReview, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpUse, bumpView, computeDedupGroups, computeLifecycleTransitions, computeQualityScores, computeScopeView, contentHash, createGateSet, emptyRecord, evaluateThreat, evolutionHome, evolutionIoAdapter, foldTurn, getRecord, latestActivityAt, lifecycleCandidate, loadMutations, loadSuppressedNames, loadUsage, markAgentCreated, memoryRoot, mutateUsage, mutationsFile, nodeEvolutionIo, normalizeUsageRecord, observeEvent, parseCuratorNominations, parseFrontmatter, recordMutation, relatedSkillNames, renderCuratorReportMarkdown, resolveOrigins, reviewPrompt, saveSuppressedNames, saveUsage, scanContentThreats, scanMemoryThreats, scanThreats, skillsRoot, suppressedFile, transactIo, updateSuppressedNames, usageFile, validateFrontmatter, verifyPromptBundle };
+export { COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_USER_CHAR_LIMIT, DSH_AUTHORING_STANDARDS, ENTRY_DELIMITER, EvolutionGateSet, LOW_QUALITY_THRESHOLD, MAX_DESCRIPTION_LENGTH, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MEMORY_REVIEW_PROMPT, MUTATIONS_FILE_VERSION, MemoryStore, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, QUALITY_WEIGHTS, SKILL_NAME_RE, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, advanceReview, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpUse, bumpView, computeDedupGroups, computeLifecycleTransitions, computeQualityScores, computeScopeView, contentHash, createGateSet, emptyRecord, evaluateThreat, evolutionHome, evolutionIoAdapter, foldTurn, getRecord, latestActivityAt, lifecycleCandidate, loadMutations, loadSuppressedNames, loadUsage, markAgentCreated, memoryRoot, mutateUsage, mutationsFile, nodeEvolutionIo, normalizeUsageRecord, observeEvent, parseCuratorNominations, parseFrontmatter, recordMutation, relatedSkillNames, renderCuratorReportMarkdown, resolveOrigins, reviewPrompt, saveSuppressedNames, saveUsage, scanContentThreats, scanMemoryThreats, scanThreats, skillsRoot, suppressedFile, transactIo, updateSuppressedNames, usageFile, validateFrontmatter, verifyPromptBundle };

package/lib/types/io.d.ts

@@ -1,9 +1,8 @@
 /**
- * Structural IO seam for the legacy facade stores.
+ * Structural IO seam for the evolution plugin family.
  *
- * The facade accepts any object exposing this small async file-tree surface.
- * Native DSH packages pass `ctx.evolutionIo.provider()`; standalone consumers
- * (and the facade's own tests) can use `nodeEvolutionIo`.
+ * Every evolution package passes `ctx.evolutionIo.provider()`; standalone
+ * consumers (and the core's own tests) can use `nodeEvolutionIo`.
  */
 export interface EvolutionIoLike {
     readText(path: string): Promise<string | null>;

package/lib/types/memory-store.d.ts

@@ -72,9 +72,6 @@ export declare class MemoryStore {
      */
     private oversizedRefusal;
     add(target: MemoryTarget, facts: string): Promise<MemoryApplyResult>;
-    replace(target: MemoryTarget, oldText: string, facts: string): Promise<MemoryApplyResult>;
-    remove(target: MemoryTarget, oldText: string): Promise<MemoryApplyResult>;
-    private mutate;
     applyBatch(target: MemoryTarget, operations: MemoryOperation[]): Promise<MemoryApplyResult>;
     renderContext(): Promise<string>;
     /**

package/lib/types/state-store.d.ts

@@ -1,26 +1,6 @@
 /**
- * Small crash-safe JSON state store for plugin-owned sidecar state.
- * Writes are atomic (temp + rename). Reads are synchronous for startup use.
+ * Evolution home path helper: `$DSH_HOME/evolution` for plugin-owned sidecar
+ * state (reports, activity store, feedback file, state-domain data).
  */
 export declare function evolutionHome(env?: NodeJS.ProcessEnv): string;
-export declare class JsonState<T> {
-    private readonly initial;
-    readonly path: string;
-    private value;
-    constructor(name: string, initial: T, env?: NodeJS.ProcessEnv);
-    /**
-     * Deep-merge persisted state over the initial defaults. Nested plain
-     * objects merge recursively (so a new default field added under an existing
-     * object is preserved), while arrays and primitives take the on-disk value
-     * wholesale. Keeps forward-compatible defaults across schema additions.
-     */
-    private static mergeDeep;
-    private loadSync;
-    get(): T;
-    set(value: T): void;
-    update(mutator: (value: T) => void): void;
-    flush(): Promise<void>;
-    /** Merge-on-load helper for persisted maps/records. */
-    reload(): Promise<void>;
-}
 //# sourceMappingURL=state-store.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.1.0-rc.50",
+  "version": "0.1.0-rc.52",
   "publishConfig": {
     "access": "public"
   },