@lmzhen/dsh-evolution-core 0.13.5 → 0.14.0

package/lib/index.js

@@ -6489,25 +6489,67 @@ function versionTarget(action) {
 	return "other";
 }
 /**
+* Which artifact one INDEX ENTRY holds.
+*
+* {@link versionTarget} reads the ACTION, which is enough for the entries a write mints under its own
+* label and is NOT enough for a {@link BASELINE_ACTION}: a baseline minted for a support write holds
+* that FILE's previous bytes while its action says only "this is what was there". Two facts recover
+* the artifact:
+*
+*  - `path` is written exactly when the bytes come from a support file, on BOTH entries one support
+*    write can mint, so it decides on its own;
+*  - an entry recorded before `path` existed has none, and the link is the evidence left: a support
+*    write names the content it replaced through `beforeHash`, so a baseline that a support write
+*    names as its predecessor holds that file's bytes.
+*
+* The inference runs only for a baseline. Every other entry keeps the action's verdict, which is also
+* the fail-closed one for an action this module does not know.
+* @param entry - one entry of a skill's index.
+* @param index - the index the entry came from: the legacy link is only readable across the whole
+*   index. Omitting it answers from `path` and the action alone.
+* @returns the artifact class; `other` when nothing attributes the bytes.
+*/
+function entryTarget(entry, index = []) {
+	if (entry.path !== void 0) return "support";
+	if (entry.action !== "baseline") return versionTarget(entry.action);
+	return index.some((candidate) => SUPPORT_ACTIONS.includes(candidate.action) && candidate.beforeHash === entry.hash) ? "support" : "other";
+}
+/**
 * Split one index into the skill body's chain and the support files' versions.
 *
 * Both share ONE index, so a skill that ever wrote a support file has two chains and
 * {@link orderVersions} cannot account for every entry (it falls back to the stored order). Splitting
 * first lets each group rebuild its own order, and keeps the body's chain intact by leaving every
-* entry the index cannot classify in it — a `baseline` predecessor is usually the body's first link.
+* entry whose artifact nothing attributes in it — a `baseline` predecessor is usually the body's
+* first link, and only the support-file baselines {@link entryTarget} recovers leave it.
 * @param versions - the stored index, oldest first as recorded.
 * @returns the two groups, each in content order when its chain is complete.
 */
 function partitionVersions(versions) {
 	const content = [];
 	const support = [];
-	for (const entry of versions) if (versionTarget(entry.action) === "support") support.push(entry);
+	for (const entry of versions) if (entryTarget(entry, versions) === "support") support.push(entry);
 	else content.push(entry);
 	return {
 		content: orderVersions(content),
 		support: orderVersions(support)
 	};
 }
+/**
+* When this skill's content last changed: the newest `at` across BOTH chains, or null when the index
+* holds nothing.
+*
+* The stored array is APPEND order and two writers of one skill can interleave, so the answer is the
+* maximum timestamp rather than the tail. Every `at` this family writes is the same ISO-8601 UTC
+* form, so comparing the strings is comparing the instants.
+* @param versions - every entry the index holds, in any order.
+* @returns the newest timestamp, or null when there is none to report.
+*/
+function latestVersionAt(versions) {
+	let newest = null;
+	for (const entry of versions) if (newest === null || entry.at > newest) newest = entry.at;
+	return newest;
+}
 /** Keep nothing less than one version, whatever the deployment asks for. */
 function clampKeep(keep) {
 	return Number.isFinite(keep) ? Math.max(1, Math.floor(keep)) : 1;
@@ -6535,21 +6577,20 @@ function readVersionEntry(entry) {
 	if (typeof candidate.action !== "string") return null;
 	if (typeof candidate.chars !== "number") return null;
 	const summary = typeof candidate.summary === "string" && candidate.summary !== "" ? candidate.summary : void 0;
+	const path = typeof candidate.path === "string" && candidate.path !== "" ? candidate.path : void 0;
 	const base = {
 		v: candidate.v,
 		at: candidate.at,
 		action: candidate.action,
 		hash: candidate.hash,
-		chars: candidate.chars
+		chars: candidate.chars,
+		...summary === void 0 ? {} : { summary },
+		...path === void 0 ? {} : { path }
 	};
 	return typeof candidate.beforeHash === "string" && candidate.beforeHash !== "" ? {
 		...base,
-		beforeHash: candidate.beforeHash,
-		...summary === void 0 ? {} : { summary }
-	} : {
-		...base,
-		...summary === void 0 ? {} : { summary }
-	};
+		beforeHash: candidate.beforeHash
+	} : base;
 }
 /**
 * Read one index body for a RECORDER: "understood", "no file", or "cannot be understood".
@@ -6609,12 +6650,14 @@ function nextHistoryIndex(versions, input, keep) {
 	const beforeHash = input.before === null ? null : contentHash(input.before);
 	const afterHash = input.after === null ? null : contentHash(input.after);
 	const grown = [...versions];
+	const pathField = input.path === void 0 ? {} : { path: input.path };
 	if (beforeHash !== null && !grown.some((entry) => entry.hash === beforeHash)) grown.push({
 		v: nextVersion(grown),
 		at: input.at,
 		action: BASELINE_ACTION,
 		hash: beforeHash,
-		chars: input.before?.length ?? 0
+		chars: input.before?.length ?? 0,
+		...pathField
 	});
 	if (afterHash !== null) {
 		if (grown[grown.length - 1]?.hash !== afterHash) grown.push({
@@ -6623,6 +6666,7 @@ function nextHistoryIndex(versions, input, keep) {
 			action: input.action,
 			hash: afterHash,
 			chars: input.after?.length ?? 0,
+			...pathField,
 			...input.summary === void 0 ? {} : { summary: input.summary },
 			...beforeHash === null ? {} : { beforeHash }
 		});
@@ -7485,7 +7529,7 @@ var SkillLibrary = class {
 		if (o.ghostDir === true) await this.cleanupGhostDir(path);
 		let result = o.result;
 		if (o.write !== null && o.audit) {
-			await this.audit(o.audit.skillName, o.audit.action, o.audit.before, o.audit.after, o.audit.summary);
+			await this.audit(o.audit.skillName, o.audit.action, o.audit.before, o.audit.after, o.audit.summary, o.audit.path);
 			const retention = contentRetentionFeedback({
 				name: o.audit.skillName,
 				action: o.audit.action,
@@ -7810,18 +7854,20 @@ var SkillLibrary = class {
 	* mutation ledger that points at it. The history failure is not silent — a deployment whose
 	* history stopped growing is a degradation worth seeing once (the ledger keeps hashes either
 	* way). */
-	async audit(skillName, action, before, after, summary) {
+	async audit(skillName, action, before, after, summary, path) {
 		const at = (/* @__PURE__ */ new Date()).toISOString();
 		let versions = null;
 		try {
 			const keep = this.limits.versionKeep ?? 20;
-			versions = await recordVersions(this.root, this.io, {
+			const input = {
 				skillName,
 				action,
 				before,
 				after,
-				at
-			}, keep);
+				at,
+				...path === void 0 ? {} : { path }
+			};
+			versions = await recordVersions(this.root, this.io, input, keep);
 		} catch (error) {
 			if (!this.historyWarned) {
 				this.historyWarned = true;
@@ -9230,7 +9276,8 @@ var SkillLibrary = class {
 					action: "write_file",
 					before: current,
 					after: content,
-					summary: `wrote ${filePath}`
+					summary: `wrote ${filePath}`,
+					path: filePath
 				},
 				event: {
 					action: "write_file",
@@ -9293,7 +9340,7 @@ var SkillLibrary = class {
 			};
 		} else if (verdict === "match") await this.io.remove(target);
 		if (verdict !== "match") return anchorRefusalFile(name, filePath, verdict);
-		await this.audit(name, "remove_file", before, null, `removed ${filePath}`);
+		await this.audit(name, "remove_file", before, null, `removed ${filePath}`, filePath);
 		this.notifyMutation({
 			action: "remove_file",
 			name,
@@ -11159,4 +11206,4 @@ function sessionAudited(ctx, sessionId, sessionScoped) {
 	return false;
 }
 //#endregion
-export { ALIVE_LOCK_TAKEOVER_MS, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, BASELINE_ACTION, CITATION_SUPPORT_DIRS, COMBINED_REVIEW_PLAN_PROMPT, COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CONTENT_SPLIT_HINT, COST_ASCII_TOKEN_HIGH, COST_ASCII_TOKEN_LOW, COST_CJK_TOKEN_HIGH, COST_CJK_TOKEN_LOW, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEAD_LOCK_TAKEOVER_MS, DEDUP_MAX_PAIR_COMPARISONS, DEDUP_SIMILARITY_THRESHOLD, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_ARCHIVE_RETENTION_POLICY, DEFAULT_CITATION_POLICY, DEFAULT_CITATION_REF_BUDGET, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MEMORY_REVIEW_MODEL, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_SKILL_VERSION_KEEP, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_SUPPORT_FILE_CHAR_POLICY, DEFAULT_SUPPORT_READ_TOOL_NAMES, DEFAULT_THREAT_MAX_SCAN_CHARS, DEFAULT_USER_CHAR_LIMIT, DISPATCH_EVENT_TYPES, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, DSH_AUTHORING_STANDARDS, EMPTY_LOCK_TAKEOVER_MS, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_ERRORS, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FAMILY_SESSION_TOOL_NAMES, FORBIDDEN_CONTROL_KEYS, HEALTH_STAMP_RE, HISTORY_DIR, HISTORY_INDEX_VERSION, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LOW_QUALITY_THRESHOLD, LostWriteLock, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, MAX_RESTRUCTURE_MOVES, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MAX_SUPPORT_READ_PATHS, MAX_TIMER_DELAY_MS, MEMORY_GUIDANCE_SECTION_ORDER, MEMORY_REVIEW_PROMPT, MIN_STAMP_BODY_CHARS, MUTATIONS_FILE_VERSION, MemoryStore, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_CATALOG_DESCRIPTION_DEFAULT, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, READ_REQUIRED_ACTIONS, RESTRUCTURE_TARGET_RE, RETENTION_FEEDBACK_KEEP_RATIO, RETENTION_FEEDBACK_MIN_CHARS, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUMMARY_DUPLICATE_HINT_THRESHOLD, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, TEXT_DIFF_MAX_CHARS, TEXT_DIFF_MAX_LINES, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UPSTREAM_LIMIT_CHARS_PER_TOKEN, VERSION_SUMMARY_MAX_CHARS, advanceReview, affinity, allowRowCollisions, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyReferenceRewrite, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, blobPath, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampedNumber, clearReviewChannel, collectReadSkillNames, composePresetComposition, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, createGateSet, daysSinceIso, decideTakeover, describeReferenceRewrite, duplicateHeadings, elapsedSince, emptyRecord, errorText, evaluateThreat, eventsFile, evidenceKindIndex, evolutionEventPayloadIssue, evolutionHome, evolutionIoAdapter, evolutionRoot, filterUnreadSkillOps, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurn, frontmatterBlock, frontmatterCatalogInvalid, getRecord, historyIndexFile, historyRoot, identity, idleDays, installParamSection, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, lifecycleCandidate, listEventArchives, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, loadVersionContent, loadVersions, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, nearDuplicateSummaries, neutralizePromptVariables, newSkillLibrary, nextHistoryIndex, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, normalizeVersionSummary, observeEvent, orderVersions, overlongLines, paramNamespace, paramSectionOverrides, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseHistoryIndex, parseLockBody, partitionVersions, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, planReferenceRewrite, planRehoming, policyStageLimits, probeAbsent, probeList, probeMtime, probePresent, probeReason, probeUnknown, projectionText, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readHistoryIndex, readNumberParam, readParam, recordMutation, recordVersions, redactSecrets, relatedSkillNames, releaseInstance, renameWithRetry, renderCuratorReportMarkdown, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, retainEventArchives, retirementReport, reviewPrompt, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionReadSkillNames, sessionSeesFamilyTools, skillReadNameOf, skillsRoot, supportFileReadOf, suppressedFile, sweepReviewChannelSessions, textDiffFacts, tokenLineFor, transactIo, transactTaskGuard, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, yamlPlainScalarNeedsQuotes };
+export { ALIVE_LOCK_TAKEOVER_MS, AUTHORING_DESCRIPTION_BAR, AUTHORING_SPLIT_LINE_CHARS, BASELINE_ACTION, CITATION_SUPPORT_DIRS, COMBINED_REVIEW_PLAN_PROMPT, COMBINED_REVIEW_PROMPT, COMPLETION_SKILL_REVIEW_PROMPT, CONTENT_SPLIT_HINT, COST_ASCII_TOKEN_HIGH, COST_ASCII_TOKEN_LOW, COST_CJK_TOKEN_HIGH, COST_CJK_TOKEN_LOW, CURATOR_DRY_RUN_BANNER, CURATOR_PROMPT, DEAD_LOCK_TAKEOVER_MS, DEDUP_MAX_PAIR_COMPARISONS, DEDUP_SIMILARITY_THRESHOLD, DEFAULT_ARCHIVE_AFTER_DAYS, DEFAULT_ARCHIVE_RETENTION_POLICY, DEFAULT_CITATION_POLICY, DEFAULT_CITATION_REF_BUDGET, DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_CURATOR_BOOT_GRACE_SECONDS, DEFAULT_CURATOR_INTERVAL_HOURS, DEFAULT_CURATOR_MODEL, DEFAULT_CURATOR_REVIEW_MAX_TOKENS, DEFAULT_HEALTH_THRESHOLDS, DEFAULT_MAX_OPS_PER_PLAN, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_MEMORY_REVIEW_MODEL, DEFAULT_MIN_IDLE_HOURS, DEFAULT_MUTATION_CAP, DEFAULT_REFERENCE_REWRITE_POLICY, DEFAULT_REVIEW_CONTEXT_MESSAGES, DEFAULT_REVIEW_MEMORY_INTERVAL, DEFAULT_REVIEW_MESSAGE_CHARS, DEFAULT_REVIEW_SKILL_INTERVAL, DEFAULT_REVIEW_TIMEOUT_MS, DEFAULT_SKILL_CONTENT_CHARS, DEFAULT_SKILL_LIMITS, DEFAULT_SKILL_REVIEW_COMPLETION_MIN_TOOL_CALLS, DEFAULT_SKILL_REVIEW_MODEL, DEFAULT_SKILL_REVIEW_TRIGGER, DEFAULT_SKILL_VERSION_KEEP, DEFAULT_STALE_AFTER_DAYS, DEFAULT_SUBSTANTIVE_MIN_AGENT_CHARS, DEFAULT_SUBSTANTIVE_MIN_TOOL_CALLS, DEFAULT_SUBSTANTIVE_MIN_USER_CHARS, DEFAULT_SUPPORT_FILE_CHAR_POLICY, DEFAULT_SUPPORT_READ_TOOL_NAMES, DEFAULT_THREAT_MAX_SCAN_CHARS, DEFAULT_USER_CHAR_LIMIT, DISPATCH_EVENT_TYPES, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, DSH_AUTHORING_STANDARDS, EMPTY_LOCK_TAKEOVER_MS, ENTRY_DELIMITER, EVENT_ARCHIVE_PREFIX, EVENT_LOG_RETAIN_ARCHIVES, EVENT_LOG_ROTATE_AT, EVENT_LOG_VERSION, EVOLUTION_ERRORS, EVOLUTION_WRITE_TOOLS, EvolutionGateSet, FAMILY_SESSION_TOOL_NAMES, FORBIDDEN_CONTROL_KEYS, HEALTH_STAMP_RE, HISTORY_DIR, HISTORY_INDEX_VERSION, HOOK_LINE_RE, INSTANCE_KEYS, KEEP_LINE_RE, LOCK_BODY_RE, LOCK_SUFFIX, LOCK_TEAR_TAKEOVER_MS, LOW_QUALITY_THRESHOLD, LostWriteLock, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MAX_DESCRIPTION_LENGTH, MAX_RESTRUCTURE_MOVES, MAX_SKILL_CONTENT_CHARS, MAX_SKILL_FILE_BYTES, MAX_SKILL_NAME_LENGTH, MAX_SUPPORT_READ_PATHS, MAX_TIMER_DELAY_MS, MEMORY_GUIDANCE_SECTION_ORDER, MEMORY_REVIEW_PROMPT, MIN_STAMP_BODY_CHARS, MUTATIONS_FILE_VERSION, MemoryStore, NATIVE_CALL_EVENT, NATIVE_RESULT_EVENT, PARAM_ALIASES, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, PATTERN_OVERLAP, PLATFORM_CATALOG_DESCRIPTION_DEFAULT, PLATFORM_ESTIMATE_CHARS_PER_TOKEN, POLICY_STAGE_DEFAULTS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, PROMPT_BUNDLE_VERSION, PROTECTED_BUILTIN_SKILLS, PTC_DISPATCH_EVENT, PTC_DISPATCH_START_EVENT, QUALITY_WEIGHTS, READ_REQUIRED_ACTIONS, RESTRUCTURE_TARGET_RE, RETENTION_FEEDBACK_KEEP_RATIO, RETENTION_FEEDBACK_MIN_CHARS, SKILLS_GUIDANCE, SKILLS_GUIDANCE_SECTION_ORDER, SKILL_ACTION_REQUIRED_FIELDS, SKILL_NAME_RE, SKILL_REVIEW_PLAN_PROMPT, SKILL_REVIEW_PROMPT, SNAPSHOT_EXTRA_NAME_RE, SUMMARY_DUPLICATE_HINT_THRESHOLD, SUPPORT_DIRS, SUPPRESSED_FILE_VERSION, SkillLibrary, TEXT_DIFF_MAX_CHARS, TEXT_DIFF_MAX_LINES, THREAT_EXEMPTION_HINT, TOKEN_ASCII_WEIGHT, TOKEN_CJK_WEIGHT, ToolDispatchNormalizer, ToolDispatchPayloadError, UPSTREAM_LIMIT_CHARS_PER_TOKEN, VERSION_SUMMARY_MAX_CHARS, advanceReview, affinity, allowRowCollisions, appendEvolutionEvent, applyCuratorLifecycleFields, applyCuratorMetaFields, applyReferenceRewrite, assertDispatchPayload, assertSkillsRootAliasRetired, assessStructureHealth, authoringFeedback, blobPath, bodyCost, buildCuratorRunReport, buildLearnPrompt, bumpPatch, bumpSupportRead, bumpUse, bumpView, callingScope, canonicalWriteId, claimInstance, clampedNumber, clearReviewChannel, collectReadSkillNames, composePresetComposition, computeDedupGroups, computeDriftSignals, computeLifecycleTransitions, computePrefixClusters, computeQualityScores, computeScopeView, contentHash, contentRetentionFeedback, countDispatches, createGateSet, daysSinceIso, decideTakeover, describeReferenceRewrite, duplicateHeadings, elapsedSince, emptyRecord, entryTarget, errorText, evaluateThreat, eventsFile, evidenceKindIndex, evolutionEventPayloadIssue, evolutionHome, evolutionIoAdapter, evolutionRoot, filterUnreadSkillOps, findDriftSignal, foldCuratorFields, foldToolDispatches, foldTurn, frontmatterBlock, frontmatterCatalogInvalid, getRecord, historyIndexFile, historyRoot, identity, idleDays, installParamSection, instanceClaimKey, instanceClaimedWriteSites, instanceHolder, isAbsent, isCommittedWarning, isDeprecatedParamId, isFileShapedPath, isMissingPath, isPresent, isProcessAlive, isProgramToolName, isReviewChannelSession, isSkillReadToolName, isSkillToolName, isUnknown, isUnreadWrite, latestActivityAt, latestVersionAt, lifecycleCandidate, listEventArchives, loadMutations, loadRowOverrides, loadSuppressedNames, loadUsage, loadVersionContent, loadVersions, makeSerialQueue, mapProbe, markAgentCreated, markReviewChannel, markerEntryName, memoryRoot, missingSupportPointers, mutateUsage, mutationsFile, narrowNameMatches, nearDuplicateSummaries, neutralizePromptVariables, newSkillLibrary, nextHistoryIndex, nodeEvolutionIo, normalizeFrontmatter, normalizeUsageRecord, normalizeVersionSummary, observeEvent, orderVersions, overlongLines, paramNamespace, paramSectionOverrides, parseCuratorNominations, parseEvolutionEvents, parseFrontmatter, parseHistoryIndex, parseLockBody, partitionVersions, pendingSelfCleanup, persistedWriteSite, persistedWriteSites, planReferenceRewrite, planRehoming, policyStageLimits, probeAbsent, probeList, probeMtime, probePresent, probeReason, probeUnknown, projectionText, readDispatchSignal, readEvolutionEvents, readEvolutionTimeline, readHistoryIndex, readNumberParam, readParam, recordMutation, recordVersions, redactSecrets, relatedSkillNames, releaseInstance, renameWithRetry, renderCuratorReportMarkdown, resolveCitations, resolveExecOrigins, resolveOrigins, resolveParamId, resolveRootConfig, resolveSkillsRoot, retainEventArchives, retirementReport, reviewPrompt, saveSuppressedNames, saveUsage, scanBodyHooks, scanContentThreats, scanMemoryThreats, scanThreats, scopedProbeReport, sessionAudited, sessionReadSkillNames, sessionSeesFamilyTools, skillReadNameOf, skillsRoot, supportFileReadOf, suppressedFile, sweepReviewChannelSessions, textDiffFacts, tokenLineFor, transactIo, transactTaskGuard, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, yamlPlainScalarNeedsQuotes };

package/lib/types/skill-history.d.ts

@@ -54,6 +54,13 @@ export interface SkillVersion {
      * (registry `skillVersionSummary`). Absent is a first-class state: the faces say so instead of
      * inventing a sentence, and a version recorded before the feature existed simply has none. */
     summary?: string;
+    /**
+     * Which support file these bytes came from, RELATIVE to the skill directory (`references/foo.md`),
+     * when this entry records a support-file write or remove. Absent is a first-class state: content
+     * versions never carry it, and every entry recorded before this field existed has none — the bytes
+     * in the blob store do not carry the name, so a legacy entry stays nameless rather than guessed.
+     */
+    path?: string;
 }
 /** One history write, carrying the content the caller already holds. */
 export interface VersionRecordInput {
@@ -66,6 +73,8 @@ export interface VersionRecordInput {
     at: string;
     /** The one-line summary of THIS write, or undefined when the deployment does not summarize. */
     summary?: string;
+    /** The support file this write touched, relative to the skill directory; undefined for content. */
+    path?: string;
 }
 /** The version numbers one write produced; a side with no content contributes nothing. */
 export interface RecordedVersions {
@@ -108,9 +117,31 @@ export type VersionTarget = 'content' | 'support' | 'other';
  * @returns the artifact class; `other` when the label does not say.
  */
 export declare function versionTarget(action: string): VersionTarget;
+/**
+ * Which artifact one INDEX ENTRY holds.
+ *
+ * {@link versionTarget} reads the ACTION, which is enough for the entries a write mints under its own
+ * label and is NOT enough for a {@link BASELINE_ACTION}: a baseline minted for a support write holds
+ * that FILE's previous bytes while its action says only "this is what was there". Two facts recover
+ * the artifact:
+ *
+ *  - `path` is written exactly when the bytes come from a support file, on BOTH entries one support
+ *    write can mint, so it decides on its own;
+ *  - an entry recorded before `path` existed has none, and the link is the evidence left: a support
+ *    write names the content it replaced through `beforeHash`, so a baseline that a support write
+ *    names as its predecessor holds that file's bytes.
+ *
+ * The inference runs only for a baseline. Every other entry keeps the action's verdict, which is also
+ * the fail-closed one for an action this module does not know.
+ * @param entry - one entry of a skill's index.
+ * @param index - the index the entry came from: the legacy link is only readable across the whole
+ *   index. Omitting it answers from `path` and the action alone.
+ * @returns the artifact class; `other` when nothing attributes the bytes.
+ */
+export declare function entryTarget(entry: SkillVersion, index?: readonly SkillVersion[]): VersionTarget;
 /** The versions of one skill, split by the artifact they hold. */
 export interface VersionGroups {
-    /** The body's versions, plus predecessors whose artifact the index cannot name. */
+    /** The body's versions, plus predecessors no evidence attributes to a support file. */
     readonly content: SkillVersion[];
     /** Support-file versions: real history, but not restorable over SKILL.md. */
     readonly support: SkillVersion[];
@@ -121,11 +152,23 @@ export interface VersionGroups {
  * Both share ONE index, so a skill that ever wrote a support file has two chains and
  * {@link orderVersions} cannot account for every entry (it falls back to the stored order). Splitting
  * first lets each group rebuild its own order, and keeps the body's chain intact by leaving every
- * entry the index cannot classify in it — a `baseline` predecessor is usually the body's first link.
+ * entry whose artifact nothing attributes in it — a `baseline` predecessor is usually the body's
+ * first link, and only the support-file baselines {@link entryTarget} recovers leave it.
  * @param versions - the stored index, oldest first as recorded.
  * @returns the two groups, each in content order when its chain is complete.
  */
 export declare function partitionVersions(versions: readonly SkillVersion[]): VersionGroups;
+/**
+ * When this skill's content last changed: the newest `at` across BOTH chains, or null when the index
+ * holds nothing.
+ *
+ * The stored array is APPEND order and two writers of one skill can interleave, so the answer is the
+ * maximum timestamp rather than the tail. Every `at` this family writes is the same ISO-8601 UTC
+ * form, so comparing the strings is comparing the instants.
+ * @param versions - every entry the index holds, in any order.
+ * @returns the newest timestamp, or null when there is none to report.
+ */
+export declare function latestVersionAt(versions: readonly SkillVersion[]): string | null;
 /** What one index file's bytes said. `absent` (no file yet) and `unreadable` (bytes that cannot be
  * understood: malformed JSON, a foreign shape, an entry this reader would have to drop, or a writer
  * NEWER than this reader) are DIFFERENT facts — the recorder must never replace the second with an

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