@lmzhen/dsh-evolution-core 0.3.49 → 0.3.51

package/lib/index.js

@@ -1611,6 +1611,28 @@ function buildLearnPrompt(userRequest) {
 	].join("\n");
 }
 //#endregion
+//#region lib/types/state-store.js
+/**
+* Evolution home path helper: `$DSH_HOME/evolution` for plugin-owned sidecar
+* state (reports, activity store, feedback file, state-domain data).
+*/
+/**
+* DSH home root: `$DSH_HOME` or `~/.dsh`. Single source of the empty-string
+* fallback — an EMPTY or WHITESPACE-ONLY DSH_HOME resolves to the default
+* home, never to a CWD-relative path (0.3.19 W1.3, 0.3.22 F-207);
+* V8-06 (0.3.47) extends the guard to whitespace (upstream home-paths:
+* `trim().length > 0` is the adoption test — `DSH_HOME=" "` must not produce
+* a sidecar under a relative "." path).
+*/
+function evolutionRoot(env = process.env) {
+	return env.DSH_HOME?.trim() ? env.DSH_HOME : join(homedir(), ".dsh");
+}
+/** 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(evolutionRoot(env), "evolution");
+}
+//#endregion
 //#region lib/types/serial.js
 /**
 * A process-local serial task queue: each task starts only after the previous
@@ -1788,7 +1810,7 @@ const PATTERNS = [
 		label: "ssh_backdoor",
 		category: "persistence",
 		scope: "strict",
-		regex: /authorized_keys/i
+		regex: /\bauthorized_keys\b/i
 	},
 	{
 		label: "agent_config_mod",
@@ -1961,7 +1983,7 @@ function previewEntries(entries) {
 	return `\n\nCurrent entries (preview):\n${shown.join("\n")}${more}`;
 }
 function memoryRoot(env = process.env) {
-	return join(env.DSH_HOME || join(homedir(), ".dsh"), "memories");
+	return join(evolutionRoot(env), "memories");
 }
 function fileFor(root, target) {
 	return join(root, target === "memory" ? "MEMORY.md" : "USER.md");
@@ -2071,7 +2093,12 @@ var MemoryStore = class {
 	* never loaded just to back it up. Failure to back up does not change the
 	* refusal semantics. V8-23⑫ (0.3.49): ONE fixed backup name per target —
 	* a fresh refusal overwrites it (the previous timestamped names accumulated
-	* per drift incident with no retention policy).
+	* per drift incident with no retention policy). V9-08 (0.3.51) declares the
+	* two failure shapes: (1) the pre-copy remove of the previous `.bak` fails —
+	* harmless, because the copy contract is overwrite (`cp force`);
+	* (2) the copy itself fails (disk/backend) — returns `null` and the refusal
+	* message simply carries no backup suffix; the refusal semantics and the
+	* on-disk file are untouched either way.
 	*/
 	async backupFile(target) {
 		const path = fileFor(this.root, target);
@@ -3056,7 +3083,7 @@ const RESTRUCTURE_TARGET_RE = /^references\/[a-z0-9](?!.*\.\.)[a-z0-9._-]*\.md$/
 /** Extra file name carried inside a snapshot's `extras/` directory. */
 const SNAPSHOT_EXTRA_NAME_RE = /^[a-z0-9][a-z0-9._-]*$/;
 function skillsRoot(env = process.env) {
-	return join(env.DSH_HOME || join(homedir(), ".dsh"), "skills");
+	return join(evolutionRoot(env), "skills");
 }
 /** 0.3.18 (S4.1, E-30): the ONE root resolution for every member that reads
 * the skills tree — tool-skill-manage / evolution-skill-catalog / skill-usage
@@ -4220,6 +4247,10 @@ var SkillLibrary = class {
 		}
 		const archived = [];
 		try {
+			if (!await this.io.readText(join(targetDir, "SKILL.md"))) return {
+				ok: false,
+				message: `Skill "${targetName}" not found.`
+			};
 			for (const source of normalizedSources) {
 				const result = await this.archive(source, { absorbedInto: targetName });
 				if (!result.ok) throw new Error(result.message);
@@ -4847,26 +4878,4 @@ var SkillLibrary = class {
 	}
 };
 //#endregion
-//#region lib/types/state-store.js
-/**
-* Evolution home path helper: `$DSH_HOME/evolution` for plugin-owned sidecar
-* state (reports, activity store, feedback file, state-domain data).
-*/
-/**
-* DSH home root: `$DSH_HOME` or `~/.dsh`. Single source of the empty-string
-* fallback — an EMPTY or WHITESPACE-ONLY DSH_HOME resolves to the default
-* home, never to a CWD-relative path (0.3.19 W1.3, 0.3.22 F-207);
-* V8-06 (0.3.47) extends the guard to whitespace (upstream home-paths:
-* `trim().length > 0` is the adoption test — `DSH_HOME=" "` must not produce
-* a sidecar under a relative "." path).
-*/
-function evolutionRoot(env = process.env) {
-	return env.DSH_HOME?.trim() ? env.DSH_HOME : join(homedir(), ".dsh");
-}
-/** 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(evolutionRoot(env), "evolution");
-}
-//#endregion
 export { AUTHORING_DESCRIPTION_BAR, COMBINED_REVIEW_PLAN_PROMPT, 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_HEALTH_THRESHOLDS, 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, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, DSH_AUTHORING_STANDARDS, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FORBIDDEN_CONTROL_KEYS, HEALTH_STAMP_RE, LOW_QUALITY_THRESHOLD, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, MAX_RESTRUCTURE_MOVES, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MEMORY_REVIEW_PROMPT, MIN_STAMP_BODY_CHARS, MUTATIONS_FILE_VERSION, MemoryStore, PATTERN_OVERLAP, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, QUALITY_WEIGHTS, RESTRUCTURE_TARGET_RE, SKILLS_GUIDANCE, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, advanceReview, appendEvolutionEvent, applyCuratorFields, applyCuratorLifecycleFields, applyCuratorMetaFields, assessStructureHealth, authoringFeedback, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpUse, bumpView, clampedNumber, composePresetComposition, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, createGateSet, duplicateHeadings, emptyRecord, evaluateThreat, eventsFile, evolutionHome, evolutionIoAdapter, evolutionRoot, findDriftSignal, foldCuratorFields, foldTurn, frontmatterBlock, frontmatterYamlUnsafeValues, getRecord, latestActivityAt, lifecycleCandidate, listEventArchives, loadMutations, loadSuppressedNames, loadUsage, makeSerialQueue, markAgentCreated, markerEntryName, memoryRoot, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, observeEvent, overlongLines, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, pendingSelfCleanup, readEvolutionEvents, readEvolutionTimeline, recordMutation, redactSecrets, relatedSkillNames, renameWithRetry, renderCuratorReportMarkdown, resolveOrigins, resolveSkillsRoot, retainEventArchives, reviewPrompt, saveSuppressedNames, saveUsage, scanContentThreats, scanMemoryThreats, scanThreats, skillsRoot, suppressedFile, transactIo, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, verifyPromptBundle, yamlPlainScalarNeedsQuotes };

package/lib/types/io.d.ts

@@ -42,9 +42,13 @@ export interface EvolutionIoLike {
     /**
      * Optional mtime-generation probe (0.3.18, E-71): the path's mtime in
      * milliseconds since epoch, or `null` when unknown (unsupported backend,
-     * missing path, stat failure). Consumers use it as a cheap invalidation
-     * stamp for a cached directory listing; a backend without it keeps
-     * event-driven invalidation only.
+     * missing path, stat failure). Intended as a cheap invalidation stamp for a
+     * cached directory listing; a backend without it keeps event-driven
+     * invalidation only. V9-07 (0.3.51): as of this release NO in-tree consumer
+     * calls it — skill-catalog invalidation is event-driven
+     * (`evolution/skill-mutated` / `evolution/skills-refresh`). The probe stays
+     * as a backend contract extension point; document it here before wiring a
+     * consumer.
      */
     mtime?(this: void, path: string): Promise<number | null>;
 }

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

@@ -67,7 +67,12 @@ export declare class MemoryStore {
      * never loaded just to back it up. Failure to back up does not change the
      * refusal semantics. V8-23⑫ (0.3.49): ONE fixed backup name per target —
      * a fresh refusal overwrites it (the previous timestamped names accumulated
-     * per drift incident with no retention policy).
+     * per drift incident with no retention policy). V9-08 (0.3.51) declares the
+     * two failure shapes: (1) the pre-copy remove of the previous `.bak` fails —
+     * harmless, because the copy contract is overwrite (`cp force`);
+     * (2) the copy itself fails (disk/backend) — returns `null` and the refusal
+     * message simply carries no backup suffix; the refusal semantics and the
+     * on-disk file are untouched either way.
      */
     private backupFile;
     /**

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.3.49",
+  "version": "0.3.51",
   "publishConfig": {
     "access": "public"
   },