@lmzhen/dsh-evolution-core 0.14.0 → 0.15.0

package/lib/index.js

@@ -6075,6 +6075,211 @@ function filterUnreadSkillOps(ops, readNames) {
 	return dropped;
 }
 //#endregion
+//#region lib/types/skill-row-cells.js
+/**
+* The cells one row shows, decided here and rendered by the client.
+*
+* Why it exists: until 0.14.1 a row's information architecture lived inside one JSX expression
+* (description + ' · ' + state + ' · ' + age), so which facts survived the browser's single-line
+* ellipsis was an accident of concatenation order — on a real library the skill row's age and
+* curation state were clipped away on EVERY row (measured 2026-09-28: 6 skills, descriptions
+* 49–61 characters, ~240px of line). A row now arrives as an ORDERED list of cells, each declaring
+* its slot, and the renderer lays them out: `aside` cells are right-aligned and never truncate, so a
+* decision fact cannot be eaten by a long description again.
+*
+* Invariants: no words live here. A cell carries either a locale key (`copy`, with the values its
+* template needs) or a verbatim fact (`literal` — numbers, hashes, recorded paths). Facts come from
+* the host; the dictionary owns every sentence and every number format, including the ones the panel
+* used to build itself (`row.delta.up`, `time.<unit>.one`, `versions.count`).
+* @module @lmzhen/dsh-evolution-core/skill-row-cells
+*/
+/** The actions whose row carries an explanatory hover text. */
+const ACTION_NOTES = {
+	delete: "action.delete.note",
+	archive: "action.archive.note"
+};
+/** The actions whose bytes come from a support file rather than from SKILL.md. */
+const SUPPORT_ACTIONS$1 = ["support-write", "support-remove"];
+/**
+* The relative-time key for one bucket: a count of one is spelled on its own.
+* @param age - the bucket the host reported.
+* @returns the locale key, singular or plural.
+*/
+function ageCopyKey(age) {
+	if (age.unit === "now") return "time.now";
+	return age.n === 1 ? "time." + age.unit + ".one" : "time." + age.unit;
+}
+/**
+* The state word one skill row carries, from the facts the listing reported.
+* @param skill - the row's facts.
+* @returns the locale key for its state.
+*/
+function skillStateKey(skill) {
+	if (skill.protectionUnknown) return "state.unknown";
+	if (skill.protectedBy !== null) return "state.protected";
+	return skill.managed ? "state.managed" : "state.foreign";
+}
+/** The hover text one action word needs, or nothing when it needs none. */
+function actionNote(actionKind) {
+	const note = ACTION_NOTES[actionKind];
+	return note === void 0 ? {} : { note };
+}
+/**
+* The cells of one version row: the facts on the title line, the summary (if any) under it.
+* @param row - the row's facts.
+* @returns both lines.
+*/
+function versionRowCells(row) {
+	const title = [
+		{
+			key: "v",
+			copy: "row.version",
+			values: { n: row.v },
+			tone: "tertiary",
+			slot: "meta"
+		},
+		{
+			key: "action",
+			copy: "action." + row.actionKind,
+			tone: "primary",
+			slot: "lead",
+			...actionNote(row.actionKind)
+		},
+		{
+			key: "time",
+			copy: ageCopyKey(row.age),
+			values: { n: row.age.n },
+			tone: "tertiary",
+			slot: "meta"
+		}
+	];
+	if (row.path !== void 0) title.push({
+		key: "path",
+		literal: row.path,
+		tone: "tertiary",
+		slot: "meta",
+		note: row.path
+	});
+	else if (SUPPORT_ACTIONS$1.includes(row.actionKind)) title.push({
+		key: "path",
+		copy: "path.unrecorded",
+		tone: "tertiary",
+		slot: "meta"
+	});
+	const delta = row.charsDelta;
+	if (delta !== void 0 && delta !== 0) title.push({
+		key: "delta",
+		copy: delta > 0 ? "row.delta.up" : "row.delta.down",
+		values: { n: Math.abs(delta) },
+		tone: "tertiary",
+		slot: "meta"
+	});
+	const meta = [];
+	if (row.summary !== void 0 && row.summary !== "") meta.push({
+		key: "summary",
+		literal: row.summary,
+		tone: "secondary",
+		slot: "lead"
+	});
+	return {
+		title,
+		meta
+	};
+}
+/**
+* The cells of one skill row: the name line, then the facts that describe it.
+*
+* The description is a `lead` cell (it is the one allowed to truncate, with the full text on hover),
+* while the version count and the last-changed time are `aside` cells — they survive any description.
+* The description is NOT pre-truncated in JavaScript: the browser's ellipsis already clips it at the
+* layout's real width, and a character cut on top of that only hides where the fact ends.
+* @param skill - the row's facts.
+* @returns both lines.
+*/
+function skillRowCells(skill) {
+	const title = [{
+		key: "name",
+		literal: skill.name,
+		tone: "primary",
+		slot: "lead",
+		note: skill.name
+	}, {
+		key: "count",
+		copy: "versions.count",
+		values: { n: skill.versions },
+		tone: "tertiary",
+		slot: "aside"
+	}];
+	const meta = [{
+		key: "description",
+		literal: skill.description,
+		tone: "tertiary",
+		slot: "lead",
+		note: skill.description
+	}, {
+		key: "state",
+		copy: skillStateKey(skill),
+		tone: "tertiary",
+		slot: "meta"
+	}];
+	if (skill.age !== null) meta.push({
+		key: "age",
+		copy: ageCopyKey(skill.age),
+		values: { n: skill.age.n },
+		tone: "tertiary",
+		slot: "aside"
+	});
+	return {
+		title,
+		meta
+	};
+}
+//#endregion
+//#region lib/types/document-body.js
+/**
+* What the panel shows when it renders one version as a document.
+*
+* Two decisions, both made here so the preview and the rendered diff cannot drift apart:
+*
+*  - FRONTMATTER IS NOT DOCUMENT TEXT. A SKILL.md opens with a YAML block; the renderer read its
+*    closing `---` as a setext underline, so the metadata line became the document's biggest heading
+*    and the real title sat below it (measured on the installed panel 2026-09-28). The block is
+*    stripped for DISPLAY only: the raw view and the body route still carry every byte, and the
+*    panel already shows the name and description on the row and in the left column.
+*  - STRIPPING FAILS OPEN. Only a block that the family's own reader accepts is removed. A document
+*    whose text merely starts with a thematic break, a block with no closing line, or a frontmatter
+*    whose body is empty is returned UNCHANGED — showing a document's first line is always better
+*    than showing nothing.
+*
+* `readingStats` exists for the other half of the reader's honesty: a preview that stops early has
+* to be able to say HOW much it is not showing.
+* @module @lmzhen/dsh-evolution-core/document-body
+*/
+/**
+* The document a reader sees: the body without its leading frontmatter block.
+* @param content - the stored bytes of one version.
+* @returns the text to render; unchanged when there is no frontmatter the reader accepts.
+*/
+function displayBodyOf(content) {
+	const block = frontmatterBlock(content);
+	if (block === null) return content;
+	if (parseFrontmatter(content) === null) return content;
+	return block.lines.slice(block.end + 1).join("\n").replace(/^\s*\n/, "");
+}
+/**
+* How much of a version the panel is showing.
+* @param full - the whole stored text.
+* @param shown - the part the route handed over.
+* @returns the counts, so the panel can say what it is not showing.
+*/
+function readingStats(full, shown) {
+	return {
+		totalChars: full.length,
+		shownChars: shown.length,
+		truncated: shown.length < full.length
+	};
+}
+//#endregion
 //#region lib/types/evidence.js
 /**
 * Which session frames are EVIDENCE, and which are bookkeeping.
@@ -11206,4 +11411,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, 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 };
+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, ageCopyKey, 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, displayBodyOf, 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, readingStats, 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, skillRowCells, skillStateKey, skillsRoot, supportFileReadOf, suppressedFile, sweepReviewChannelSessions, textDiffFacts, tokenLineFor, transactIo, transactTaskGuard, unhookedSupportPointers, updateSuppressedNames, usageFile, usageObserved, validateFrontmatter, validateRestructureTarget, valueOr, verifyPromptBundle, versionActionKind, versionRowCells, versionSummaryPrompt, versionTarget, vocabulary, writeDurableTmp, yamlPlainScalarNeedsQuotes };

package/lib/types/document-body.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The document a reader sees: the body without its leading frontmatter block.
+ * @param content - the stored bytes of one version.
+ * @returns the text to render; unchanged when there is no frontmatter the reader accepts.
+ */
+export declare function displayBodyOf(content: string): string;
+/** How much of one version the reader is looking at. */
+export interface ReadingStats {
+    /** Characters in the stored version. */
+    readonly totalChars: number;
+    /** Characters the panel holds (the route's own bound). */
+    readonly shownChars: number;
+    /** Whether anything was left out. */
+    readonly truncated: boolean;
+}
+/**
+ * How much of a version the panel is showing.
+ * @param full - the whole stored text.
+ * @param shown - the part the route handed over.
+ * @returns the counts, so the panel can say what it is not showing.
+ */
+export declare function readingStats(full: string, shown: string): ReadingStats;
+//# sourceMappingURL=document-body.d.ts.map

package/lib/types/index.d.ts

@@ -53,6 +53,8 @@ export * from './scope.ts';
 export * from './skill-health.ts';
 export * from './signals.ts';
 export * from './skill-reads.ts';
+export * from './skill-row-cells.ts';
+export * from './document-body.ts';
 export * from './evidence.ts';
 export * from './drift-signals.ts';
 export * from './skill-history.ts';

package/lib/types/skill-row-cells.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The cells one row shows, decided here and rendered by the client.
+ *
+ * Why it exists: until 0.14.1 a row's information architecture lived inside one JSX expression
+ * (description + ' · ' + state + ' · ' + age), so which facts survived the browser's single-line
+ * ellipsis was an accident of concatenation order — on a real library the skill row's age and
+ * curation state were clipped away on EVERY row (measured 2026-09-28: 6 skills, descriptions
+ * 49–61 characters, ~240px of line). A row now arrives as an ORDERED list of cells, each declaring
+ * its slot, and the renderer lays them out: `aside` cells are right-aligned and never truncate, so a
+ * decision fact cannot be eaten by a long description again.
+ *
+ * Invariants: no words live here. A cell carries either a locale key (`copy`, with the values its
+ * template needs) or a verbatim fact (`literal` — numbers, hashes, recorded paths). Facts come from
+ * the host; the dictionary owns every sentence and every number format, including the ones the panel
+ * used to build itself (`row.delta.up`, `time.<unit>.one`, `versions.count`).
+ * @module @lmzhen/dsh-evolution-core/skill-row-cells
+ */
+/** Where a cell sits in its row. `aside` is right-aligned and never truncated. */
+export type CellSlot = 'lead' | 'meta' | 'aside';
+/** The visual register a cell speaks in; the client maps it to a design token. */
+export type CellTone = 'primary' | 'secondary' | 'tertiary';
+/** What every cell carries, whichever kind it is. */
+export interface RowCellBase {
+    /** Stable identity, for the renderer's key and for a spec to name one cell. */
+    readonly key: string;
+    /** Where it sits. */
+    readonly slot: CellSlot;
+    /** Which register it speaks in. */
+    readonly tone: CellTone;
+    /** Hover text (a locale key) when the row would otherwise hide the full value. */
+    readonly note?: string;
+}
+/** A sentence: the locale key plus the values its template interpolates. */
+export interface CopyCell extends RowCellBase {
+    readonly copy: string;
+    readonly values?: Readonly<Record<string, string | number>>;
+}
+/** A fact shown verbatim (a version number, a path, a summary the model wrote). */
+export interface LiteralCell extends RowCellBase {
+    readonly literal: string;
+}
+/** One cell. Narrow with `'copy' in cell`. */
+export type RowCell = CopyCell | LiteralCell;
+/** The lines one row can show: a title line, and a meta line under it. */
+export interface RowCells {
+    readonly title: readonly RowCell[];
+    readonly meta: readonly RowCell[];
+}
+/** The facts a version row needs. The client's `VersionRow` satisfies this structurally. */
+export interface VersionRowFacts {
+    readonly v: number;
+    readonly actionKind: string;
+    readonly age: {
+        readonly unit: string;
+        readonly n: number;
+    };
+    readonly charsDelta?: number;
+    readonly path?: string;
+    readonly summary?: string;
+}
+/** The facts a skill row needs. The client's `SkillRow` satisfies this structurally. */
+export interface SkillRowFacts {
+    readonly name: string;
+    readonly versions: number;
+    readonly description: string;
+    readonly managed: boolean;
+    readonly protectedBy: string | null;
+    readonly protectionUnknown: boolean;
+    readonly age: {
+        readonly unit: string;
+        readonly n: number;
+    } | null;
+}
+/**
+ * The relative-time key for one bucket: a count of one is spelled on its own.
+ * @param age - the bucket the host reported.
+ * @returns the locale key, singular or plural.
+ */
+export declare function ageCopyKey(age: {
+    readonly unit: string;
+    readonly n: number;
+}): string;
+/**
+ * The state word one skill row carries, from the facts the listing reported.
+ * @param skill - the row's facts.
+ * @returns the locale key for its state.
+ */
+export declare function skillStateKey(skill: SkillRowFacts): string;
+/**
+ * The cells of one version row: the facts on the title line, the summary (if any) under it.
+ * @param row - the row's facts.
+ * @returns both lines.
+ */
+export declare function versionRowCells(row: VersionRowFacts): RowCells;
+/**
+ * The cells of one skill row: the name line, then the facts that describe it.
+ *
+ * The description is a `lead` cell (it is the one allowed to truncate, with the full text on hover),
+ * while the version count and the last-changed time are `aside` cells — they survive any description.
+ * The description is NOT pre-truncated in JavaScript: the browser's ellipsis already clips it at the
+ * layout's real width, and a character cut on top of that only hides where the fact ends.
+ * @param skill - the row's facts.
+ * @returns both lines.
+ */
+export declare function skillRowCells(skill: SkillRowFacts): RowCells;
+//# sourceMappingURL=skill-row-cells.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.14.0",
+  "version": "0.15.0",
   "publishConfig": {
     "access": "public"
   },