dsh-mnemon-source-runtime 0.5.14 → 0.5.16

package/README.md

@@ -19,7 +19,13 @@ Choose an existing data authority deliberately. Without `dataDir`, each stable S
 
 Disabling participation does not delete stored entries. Source data remains separate from the current turn's projection and access grants.
 
-Model projections annotate each entry with its recorded importance and elapsed whole-day ages, for example `[importance=critical; created=14d; updated=2d]`, followed by the exact content. Future timestamps show `future`; unparseable ones show `unknown`. Ages are captured once per projection and remain fixed for that turn. Annotations count toward the Strategy's projection budget, but do not change stored JSON/Markdown, content matching or storage capacity. For replacement/removal, use only the entry content. Current instructions retain priority.
+Model projections omit default `importance=normal` and whole-day ages of `0d`; they annotate entries only when non-default fields remain, for example `[importance=critical; created=14d; updated=2d]`, followed by the exact content. Future timestamps show `future`; unparseable ones show `unknown`. Ages are captured once per projection and remain fixed for that turn. Annotations count toward the Strategy's projection budget, but do not change stored JSON/Markdown, content matching or storage capacity. For replacement/removal, use only the entry content. Current instructions retain priority. Model-facing text omits revision hashes and quota/count statistics, while the Source protocol and management/UI retain them. File boundaries and all visible content remain; no low-importance entry is automatically hidden.
+
+## Storage files
+
+The `./contracts` entry names this Source's files under a storage root (`runtime/memories.json`, `USER.md`, `MEMORY.md`, the `.memories.lock` lock and the `archived/` local archive) and exports the rules a copy of them follows: `runtimeProjection` and `runtimeBytes` write and count USER.md and MEMORY.md exactly as the controller does, and `summarizeRuntimeMemories` counts a stored file for an inventory. They are pure and browser-safe. The `dsh-mnemon` Starter's backup, sync and storage inventory use them instead of keeping copies.
+
+The same entry exports the size limits the configuration and the controller apply: `RUNTIME_MEMORY_LIMITS`, the default limit of USER.md and of MEMORY.md, and `RUNTIME_MEMORY_LIMIT_MAX_BYTES`, the largest limit either may be given. The Starter's settings take their defaults and bounds from them.
 
 ## Source-owned UI and tests
 

package/lib/client.js

@@ -104,7 +104,7 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region \0source-css:/home/runner/work/dsh-mnemon/dsh-mnemon/plugins/dsh-mnemon-source-runtime/presentation/page.module.css.mjs
-		const css$2 = ".IIa07q_runtimeComposer{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);margin-bottom:12px;padding:16px}.IIa07q_runtimeComposerHeading{justify-content:space-between;align-items:flex-start;gap:16px;margin-bottom:12px;display:flex}.IIa07q_runtimeComposerHeading h3{margin:0 0 2px;font-size:14px;font-weight:500;line-height:22px}.IIa07q_runtimeComposerHeading p{color:var(--mn-faint);margin:0;font-size:12px;line-height:18px}.IIa07q_runtimeComposerHeading>span{color:var(--mn-muted);background:var(--mn-fill);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_runtimeComposer>textarea,.IIa07q_runtimeEntry textarea{resize:vertical;border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;color:var(--mn-text);background:var(--mn-input);outline:0;padding:8px 10px;font-size:13px;line-height:20px}.IIa07q_runtimeComposer>textarea:focus,.IIa07q_runtimeEntry textarea:focus{border-color:var(--mn-accent)}.IIa07q_runtimeComposerActions{justify-content:flex-end;align-items:flex-end;gap:8px;margin-top:12px;display:flex}.IIa07q_runtimeComposerActions label{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_runtimeChoice button{min-width:136px}.IIa07q_runtimeReadOnly{border-radius:var(--dsw-radius-md);color:var(--mn-muted);background:var(--mn-fill);margin-bottom:12px;padding:8px 12px;font-size:12px;line-height:18px}.IIa07q_runtimeSummaryGrid{grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin-bottom:12px;display:grid}.IIa07q_runtimeSummaryCard{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);min-width:0}.IIa07q_runtimeBrowser{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);overflow:hidden}.IIa07q_runtimeBrowserToolbar{border-bottom:.5px solid var(--mn-line);justify-content:space-between;align-items:center;gap:12px;padding:10px 12px;display:flex}.IIa07q_runtimeScopeFilter{border-radius:var(--dsw-radius-md);background:var(--mn-hover);flex-wrap:wrap;align-items:center;gap:2px;padding:3px;display:inline-flex}.IIa07q_runtimeScopeFilter button{border-radius:var(--dsw-radius-sm);min-height:28px;color:var(--mn-muted);cursor:pointer;background:0 0;border:0;padding:0 12px;font-size:13px;font-weight:500;line-height:20px}.IIa07q_runtimeScopeFilter button:hover{color:var(--mn-text)}.IIa07q_runtimeScopeFilter button[data-active]{color:var(--mn-text);background:var(--mn-layer-1);box-shadow:var(--dsw-elevation-soft)}.IIa07q_runtimeScopeFilter b{color:var(--mn-faint);font-variant-numeric:tabular-nums;margin-left:6px;font-size:12px;font-weight:400}.IIa07q_runtimeFilterQuery{width:min(320px,42%);min-width:210px}.IIa07q_runtimeUnifiedList{grid-template-columns:1fr;gap:8px;padding:12px;display:grid}.IIa07q_runtimeEntryBadges{flex-wrap:wrap;align-items:center;gap:6px;display:flex}.IIa07q_runtimeEntryMeta .IIa07q_runtimeEntryTarget{color:var(--mn-accent);background:color-mix(in srgb, var(--mn-accent) 10%, transparent)}.IIa07q_runtimeEntryMeta .IIa07q_runtimeEntryBranch{text-overflow:ellipsis;white-space:nowrap;max-width:140px;color:var(--mn-muted);background:var(--mn-fill);font-family:var(--mn-code);overflow:hidden}.IIa07q_runtimeComposerBranch{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_runtimeComposerBranch input{border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;height:36px;color:var(--mn-text);background:var(--mn-input);outline:0;padding:0 10px;font-size:13px;font-weight:400}.IIa07q_runtimeComposerBranch input:focus{border-color:var(--mn-accent)}.IIa07q_bodyEditBranch{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_bodyEditBranch input{border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;height:32px;color:var(--mn-text);background:var(--mn-input);outline:0;padding:0 10px;font-size:13px;font-weight:400}.IIa07q_bodyEditBranch input:focus{border-color:var(--mn-accent)}.IIa07q_bodyEditBranch small{color:var(--mn-faint);font-size:12px;font-weight:400}.IIa07q_runtimeTargetHeader{justify-content:space-between;align-items:center;gap:16px;padding:14px 16px 8px;display:flex}.IIa07q_runtimeTargetHeader>div{gap:0;display:grid}.IIa07q_runtimeTargetHeader span{color:var(--mn-faint);font-family:var(--mn-code);font-size:11px;line-height:16px}.IIa07q_runtimeTargetHeader h3{margin:0;font-size:14px;font-weight:500;line-height:22px}.IIa07q_runtimeTargetHeader>strong{color:var(--mn-muted);background:var(--mn-fill);font-variant-numeric:tabular-nums;border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_capacityLine{align-items:center;gap:10px;padding:0 16px;display:flex}.IIa07q_capacityLine>div{background:var(--mn-fill);border-radius:999px;flex:1;height:4px;overflow:hidden}.IIa07q_capacityLine i{border-radius:inherit;background:var(--dsw-alias-brand-primary);height:100%;transition:width .25s;display:block}.IIa07q_capacityLine>span{min-width:88px;color:var(--mn-faint);text-align:right;font-variant-numeric:tabular-nums;font-size:11px}.IIa07q_runtimeTargetDescription{min-height:36px;color:var(--mn-faint);margin:8px 16px 14px;font-size:12px;line-height:18px}.IIa07q_runtimeEntry{--mn-provider-color:var(--mn-accent);border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-md);padding:12px 14px 10px;position:relative}.IIa07q_runtimeEntry[data-importance=critical]{--mn-provider-color:var(--mn-priority)}.IIa07q_runtimeEntry[data-importance=low]{--mn-provider-color:var(--mn-faint)}.IIa07q_runtimeEntry[data-focused]{border-color:color-mix(in srgb, var(--mn-accent) 60%, var(--mn-card-line));box-shadow:0 0 0 2px color-mix(in srgb, var(--mn-accent) 14%, transparent)}.IIa07q_runtimeEntryMeta{justify-content:space-between;align-items:center;gap:12px;display:flex}.IIa07q_runtimeEntryMeta>span,.IIa07q_runtimeEntryBadges>span{color:var(--mn-muted);background:var(--mn-fill);border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_runtimeEntry[data-importance=critical] .IIa07q_runtimeEntryMeta>span,.IIa07q_runtimeEntry[data-importance=critical] .IIa07q_runtimeEntryBadges>span:not(.IIa07q_runtimeEntryTarget){color:var(--mn-warn);background:color-mix(in srgb, var(--mn-warn) 12%, transparent)}.IIa07q_runtimeEntryMeta time{color:var(--mn-faint);text-overflow:ellipsis;white-space:nowrap;font-variant-numeric:tabular-nums;font-size:11px;overflow:hidden}.IIa07q_runtimeEntry>p{white-space:pre-wrap;overflow-wrap:anywhere;margin:8px 0;font-size:14px;line-height:22px}.IIa07q_runtimeEntry>select{margin-top:8px}.IIa07q_runtimeEntry footer{border-top:.5px solid var(--mn-line);justify-content:flex-end;align-items:center;gap:8px;min-height:32px;margin-top:8px;padding-top:8px;display:flex}.IIa07q_runtimeEntry footer>span{color:var(--mn-danger);margin-right:auto;font-size:12px}.IIa07q_runtimeEmpty{min-height:128px;color:var(--mn-faint);text-align:center;align-content:center;place-items:center;gap:6px;display:grid}.IIa07q_runtimeEmpty>span{font-size:20px;line-height:1}.IIa07q_runtimeEmpty p{margin:0;font-size:13px;line-height:20px}@media (width<=1000px){.IIa07q_runtimeSummaryGrid{grid-template-columns:1fr}}@media (width<=760px){.IIa07q_runtimeComposerHeading,.IIa07q_runtimeComposerActions{flex-direction:column;align-items:stretch}.IIa07q_runtimeComposerActions>*,.IIa07q_runtimeComposerActions button{width:100%}.IIa07q_runtimeBrowserToolbar{flex-direction:column;align-items:stretch}.IIa07q_runtimeFilterQuery{width:100%;min-width:0}}";
+		const css$2 = ".IIa07q_runtimeComposer{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);margin-bottom:12px;padding:16px}.IIa07q_runtimeComposerHeading{justify-content:space-between;align-items:flex-start;gap:16px;margin-bottom:12px;display:flex}.IIa07q_runtimeComposerHeading h3{margin:0 0 2px;font-size:14px;font-weight:500;line-height:22px}.IIa07q_runtimeComposerHeading p{color:var(--mn-faint);margin:0;font-size:12px;line-height:18px}.IIa07q_runtimeComposerHeading>span{color:var(--mn-muted);background:var(--mn-fill);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_runtimeComposer>textarea,.IIa07q_runtimeEntry textarea{resize:vertical;border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;color:var(--mn-text);background:var(--mn-input);outline:0;padding:8px 10px;font-size:13px;line-height:20px}.IIa07q_runtimeComposer>textarea:focus,.IIa07q_runtimeEntry textarea:focus{border-color:var(--mn-accent)}.IIa07q_runtimeComposerActions{justify-content:flex-end;align-items:flex-end;gap:8px;margin-top:12px;display:flex}.IIa07q_runtimeComposerActions label{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_runtimeChoice button{min-width:136px}.IIa07q_runtimeReadOnly{border-radius:var(--dsw-radius-md);color:var(--mn-muted);background:var(--mn-block-fill,var(--mn-fill));margin-bottom:12px;padding:8px 12px;font-size:12px;line-height:18px}.IIa07q_runtimeSummaryGrid{grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin-bottom:12px;display:grid}.IIa07q_runtimeSummaryCard{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);min-width:0}.IIa07q_runtimeBrowser{border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-lg);overflow:hidden}.IIa07q_runtimeBrowserToolbar{border-bottom:.5px solid var(--mn-line);justify-content:space-between;align-items:center;gap:12px;padding:10px 12px;display:flex}.IIa07q_runtimeScopeFilter{border-radius:var(--dsw-radius-md);background:var(--mn-hover);flex-wrap:wrap;align-items:center;gap:2px;padding:3px;display:inline-flex}.IIa07q_runtimeScopeFilter button{border-radius:var(--dsw-radius-sm);min-height:28px;color:var(--mn-muted);cursor:pointer;background:0 0;border:0;padding:0 12px;font-size:13px;font-weight:500;line-height:20px}.IIa07q_runtimeScopeFilter button:hover{color:var(--mn-text)}.IIa07q_runtimeScopeFilter button[data-active]{color:var(--mn-text);background:var(--mn-layer-1);box-shadow:var(--dsw-elevation-soft)}.IIa07q_runtimeScopeFilter b{color:var(--mn-faint);font-variant-numeric:tabular-nums;margin-left:6px;font-size:12px;font-weight:400}.IIa07q_runtimeFilterQuery{width:min(320px,42%);min-width:210px}.IIa07q_runtimeUnifiedList{grid-template-columns:1fr;gap:8px;padding:12px;display:grid}.IIa07q_runtimeEntryBadges{flex-wrap:wrap;align-items:center;gap:6px;display:flex}.IIa07q_runtimeEntryMeta .IIa07q_runtimeEntryTarget{color:var(--mn-accent);background:color-mix(in srgb, var(--mn-accent) 10%, transparent)}.IIa07q_runtimeEntryMeta .IIa07q_runtimeEntryBranch{text-overflow:ellipsis;white-space:nowrap;max-width:140px;color:var(--mn-muted);background:var(--mn-fill);font-family:var(--mn-code);overflow:hidden}.IIa07q_runtimeComposerBranch{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_runtimeComposerBranch input{border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;height:36px;color:var(--mn-text);background:var(--mn-input);outline:0;padding:0 10px;font-size:13px;font-weight:400}.IIa07q_runtimeComposerBranch input:focus{border-color:var(--mn-accent)}.IIa07q_bodyEditBranch{color:var(--mn-muted);gap:6px;font-size:12px;font-weight:500;line-height:18px;display:grid}.IIa07q_bodyEditBranch input{border:.5px solid var(--mn-field-line);border-radius:var(--dsw-radius-md);width:100%;height:32px;color:var(--mn-text);background:var(--mn-input);outline:0;padding:0 10px;font-size:13px;font-weight:400}.IIa07q_bodyEditBranch input:focus{border-color:var(--mn-accent)}.IIa07q_bodyEditBranch small{color:var(--mn-faint);font-size:12px;font-weight:400}.IIa07q_runtimeTargetHeader{justify-content:space-between;align-items:center;gap:16px;padding:14px 16px 8px;display:flex}.IIa07q_runtimeTargetHeader>div{gap:0;display:grid}.IIa07q_runtimeTargetHeader span{color:var(--mn-faint);font-family:var(--mn-code);font-size:11px;line-height:16px}.IIa07q_runtimeTargetHeader h3{margin:0;font-size:14px;font-weight:500;line-height:22px}.IIa07q_runtimeTargetHeader>strong{color:var(--mn-muted);background:var(--mn-fill);font-variant-numeric:tabular-nums;border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_capacityLine{align-items:center;gap:10px;padding:0 16px;display:flex}.IIa07q_capacityLine>div{background:var(--mn-fill);border-radius:999px;flex:1;height:4px;overflow:hidden}.IIa07q_capacityLine i{border-radius:inherit;background:var(--dsw-alias-brand-primary);height:100%;transition:width .25s;display:block}.IIa07q_capacityLine>span{min-width:88px;color:var(--mn-faint);text-align:right;font-variant-numeric:tabular-nums;font-size:11px}.IIa07q_runtimeTargetDescription{min-height:36px;color:var(--mn-faint);margin:8px 16px 14px;font-size:12px;line-height:18px}.IIa07q_runtimeEntry{--mn-provider-color:var(--mn-accent);border:.5px solid var(--mn-card-line);border-radius:var(--dsw-radius-md);padding:12px 14px 10px;position:relative}.IIa07q_runtimeEntry[data-importance=critical]{--mn-provider-color:var(--mn-priority)}.IIa07q_runtimeEntry[data-importance=low]{--mn-provider-color:var(--mn-faint)}.IIa07q_runtimeEntry[data-focused]{border-color:color-mix(in srgb, var(--mn-accent) 60%, var(--mn-card-line));box-shadow:0 0 0 2px color-mix(in srgb, var(--mn-accent) 14%, transparent)}.IIa07q_runtimeEntryMeta{justify-content:space-between;align-items:center;gap:12px;display:flex}.IIa07q_runtimeEntryMeta>span,.IIa07q_runtimeEntryBadges>span{color:var(--mn-muted);background:var(--mn-fill);border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}.IIa07q_runtimeEntry[data-importance=critical] .IIa07q_runtimeEntryMeta>span,.IIa07q_runtimeEntry[data-importance=critical] .IIa07q_runtimeEntryBadges>span:not(.IIa07q_runtimeEntryTarget){color:var(--mn-warn);background:color-mix(in srgb, var(--mn-warn) 12%, transparent)}.IIa07q_runtimeEntryMeta time{color:var(--mn-faint);text-overflow:ellipsis;white-space:nowrap;font-variant-numeric:tabular-nums;font-size:11px;overflow:hidden}.IIa07q_runtimeEntry>p{white-space:pre-wrap;overflow-wrap:anywhere;margin:8px 0;font-size:14px;line-height:22px}.IIa07q_runtimeEntry>select{margin-top:8px}.IIa07q_runtimeEntry footer{border-top:.5px solid var(--mn-line);justify-content:flex-end;align-items:center;gap:8px;min-height:32px;margin-top:8px;padding-top:8px;display:flex}.IIa07q_runtimeEntry footer>span{color:var(--mn-danger);margin-right:auto;font-size:12px}.IIa07q_runtimeEmpty{min-height:128px;color:var(--mn-faint);text-align:center;align-content:center;place-items:center;gap:6px;display:grid}.IIa07q_runtimeEmpty>span{font-size:20px;line-height:1}.IIa07q_runtimeEmpty p{margin:0;font-size:13px;line-height:20px}@media (width<=1000px){.IIa07q_runtimeSummaryGrid{grid-template-columns:1fr}}@media (width<=760px){.IIa07q_runtimeComposerHeading,.IIa07q_runtimeComposerActions{flex-direction:column;align-items:stretch}.IIa07q_runtimeComposerActions>*,.IIa07q_runtimeComposerActions button{width:100%}.IIa07q_runtimeBrowserToolbar{flex-direction:column;align-items:stretch}.IIa07q_runtimeFilterQuery{width:100%;min-width:0}}";
 		const id$1 = "dsh-mnemon-source-runtime/presentation/page.module.css";
 		if (typeof document !== "undefined") {
 			let tag = document.querySelector("style[data-plugin-css=" + JSON.stringify(id$1) + "]");

package/lib/contracts-DycwaUv_.js

@@ -0,0 +1,81 @@
+//#region src/defaults.ts
+const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES = 10240;
+const DEFAULT_RUNTIME_USER_LIMIT_BYTES = 4096;
+const MAX_RUNTIME_MEMORY_LIMIT_BYTES = 1048576;
+//#endregion
+//#region src/contracts.ts
+const RUNTIME_MEMORY_VERSION = 1;
+const RUNTIME_ENTRY_DELIMITER = "\n§\n";
+const RUNTIME_MEMORY_LIMITS = {
+	memory: DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES,
+	user: DEFAULT_RUNTIME_USER_LIMIT_BYTES
+};
+/** The largest limit, in UTF-8 bytes, either target's file may be given. */
+const RUNTIME_MEMORY_LIMIT_MAX_BYTES = MAX_RUNTIME_MEMORY_LIMIT_BYTES;
+/** The longest git branch name a scope may hold. */
+const RUNTIME_BRANCH_NAME_MAX = 128;
+/** The characters a git branch name in a scope may use. */
+const RUNTIME_BRANCH_NAME_PATTERN = /^[A-Za-z0-9._/-]+$/u;
+/**
+* Read a stored branch scope. Absent or malformed data reads as no scope, so an entry that
+* a hand edit or another installation left malformed is projected on every branch instead
+* of breaking the projection that reads it.
+*/
+function parseRuntimeBranches(value) {
+	if (!Array.isArray(value)) return void 0;
+	const branches = [];
+	for (const item of value) {
+		if (typeof item !== "string" || item === "" || item.length > 128 || !RUNTIME_BRANCH_NAME_PATTERN.test(item)) return void 0;
+		branches.push(item);
+	}
+	return branches;
+}
+/** The Runtime Source's directory under a storage root. */
+const RUNTIME_DIRECTORY = "runtime";
+/** The entries themselves, the source of truth the projections are written from. */
+const RUNTIME_MEMORIES_FILE = "memories.json";
+/** Each target's projection: its entries' plain content, the file a person reads. */
+const RUNTIME_PROJECTION_FILES = {
+	user: "USER.md",
+	memory: "MEMORY.md"
+};
+/** Created exclusively while the files above are read or written; whoever copies them takes it too. */
+const RUNTIME_LOCK_FILE = ".memories.lock";
+/** A lock file older than this was left by a process that stopped, and may be taken over. */
+const RUNTIME_LOCK_STALE_MS = 3e4;
+/** The local archive of entries that left MEMORY.md while no Memory Space could take them (#336). */
+const RUNTIME_ARCHIVE_DIRECTORY = "archived";
+/** The longest content one entry may hold, in UTF-8 bytes. */
+const RUNTIME_ENTRY_MAX_BYTES = 8192;
+let utf8;
+function joinedContent(entries, target) {
+	return entries.filter((entry) => entry.target === target).map((entry) => entry.content).join(RUNTIME_ENTRY_DELIMITER);
+}
+/** The UTF-8 bytes one target's entries take against its limit: their contents joined by the delimiter. */
+function runtimeBytes(entries, target) {
+	utf8 ??= new TextEncoder();
+	return utf8.encode(joinedContent(entries, target)).byteLength;
+}
+/** One target's projection file, USER.md or MEMORY.md, exactly as the Runtime Source writes it. */
+function runtimeProjection(entries, target) {
+	const content = joinedContent(entries, target);
+	return content === "" ? "" : `${content}\n`;
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Count the entries of a parsed memories.json for a read-only inventory. It never throws: a file
+* without an entry list is not `valid`, and a malformed entry is counted or skipped, never refused.
+*/
+function summarizeRuntimeMemories(value) {
+	const entries = isObject(value) && Array.isArray(value.entries) ? value.entries.filter(isObject) : [];
+	return {
+		valid: isObject(value) && Array.isArray(value.entries),
+		entries: entries.length,
+		user: entries.filter((entry) => entry.target === "user").length,
+		memory: entries.filter((entry) => entry.target === "memory").length
+	};
+}
+//#endregion
+export { summarizeRuntimeMemories as _, RUNTIME_ENTRY_DELIMITER as a, MAX_RUNTIME_MEMORY_LIMIT_BYTES as b, RUNTIME_LOCK_STALE_MS as c, RUNTIME_MEMORY_LIMIT_MAX_BYTES as d, RUNTIME_MEMORY_VERSION as f, runtimeProjection as g, runtimeBytes as h, RUNTIME_DIRECTORY as i, RUNTIME_MEMORIES_FILE as l, parseRuntimeBranches as m, RUNTIME_BRANCH_NAME_MAX as n, RUNTIME_ENTRY_MAX_BYTES as o, RUNTIME_PROJECTION_FILES as p, RUNTIME_BRANCH_NAME_PATTERN as r, RUNTIME_LOCK_FILE as s, RUNTIME_ARCHIVE_DIRECTORY as t, RUNTIME_MEMORY_LIMITS as u, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES as v, DEFAULT_RUNTIME_USER_LIMIT_BYTES as y };

package/lib/contracts.d.ts

@@ -97,6 +97,8 @@ interface RuntimeMemoryLimits {
   readonly user: number;
 }
 declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
+/** The largest limit, in UTF-8 bytes, either target's file may be given. */
+declare const RUNTIME_MEMORY_LIMIT_MAX_BYTES: number;
 /** The longest git branch name a scope may hold. */
 declare const RUNTIME_BRANCH_NAME_MAX = 128;
 /** The characters a git branch name in a scope may use. */
@@ -107,5 +109,41 @@ declare const RUNTIME_BRANCH_NAME_PATTERN: RegExp;
  * of breaking the projection that reads it.
  */
 declare function parseRuntimeBranches(value: unknown): string[] | undefined;
+/** The Runtime Source's directory under a storage root. */
+declare const RUNTIME_DIRECTORY = "runtime";
+/** The entries themselves, the source of truth the projections are written from. */
+declare const RUNTIME_MEMORIES_FILE = "memories.json";
+/** Each target's projection: its entries' plain content, the file a person reads. */
+declare const RUNTIME_PROJECTION_FILES: {
+  readonly user: "USER.md";
+  readonly memory: "MEMORY.md";
+};
+/** Created exclusively while the files above are read or written; whoever copies them takes it too. */
+declare const RUNTIME_LOCK_FILE = ".memories.lock";
+/** A lock file older than this was left by a process that stopped, and may be taken over. */
+declare const RUNTIME_LOCK_STALE_MS = 30000;
+/** The local archive of entries that left MEMORY.md while no Memory Space could take them (#336). */
+declare const RUNTIME_ARCHIVE_DIRECTORY = "archived";
+/** The longest content one entry may hold, in UTF-8 bytes. */
+declare const RUNTIME_ENTRY_MAX_BYTES: number;
+type RuntimeEntryText = Pick<RuntimeMemoryEntry, 'target' | 'content'>;
+/** The UTF-8 bytes one target's entries take against its limit: their contents joined by the delimiter. */
+declare function runtimeBytes(entries: ReadonlyArray<RuntimeEntryText>, target: RuntimeMemoryTarget): number;
+/** One target's projection file, USER.md or MEMORY.md, exactly as the Runtime Source writes it. */
+declare function runtimeProjection(entries: ReadonlyArray<RuntimeEntryText>, target: RuntimeMemoryTarget): string;
+/** What a stored memories.json holds, counted without judging each entry. */
+interface RuntimeMemoriesSummary {
+  /** Whether the file has an entry list at all. Without one, every count is 0. */
+  valid: boolean;
+  /** Every entry that is an object, whatever its target. */
+  entries: number;
+  user: number;
+  memory: number;
+}
+/**
+ * Count the entries of a parsed memories.json for a read-only inventory. It never throws: a file
+ * without an entry list is not `valid`, and a malformed entry is counted or skipped, never refused.
+ */
+declare function summarizeRuntimeMemories(value: unknown): RuntimeMemoriesSummary;
 //#endregion
-export { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches };
+export { RUNTIME_ARCHIVE_DIRECTORY, RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_DIRECTORY, RUNTIME_ENTRY_DELIMITER, RUNTIME_ENTRY_MAX_BYTES, RUNTIME_LOCK_FILE, RUNTIME_LOCK_STALE_MS, RUNTIME_MEMORIES_FILE, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_LIMIT_MAX_BYTES, RUNTIME_MEMORY_VERSION, RUNTIME_PROJECTION_FILES, RuntimeMemoriesSummary, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches, runtimeBytes, runtimeProjection, summarizeRuntimeMemories };

package/lib/contracts.js

@@ -1,2 +1,2 @@
-import { a as RUNTIME_MEMORY_VERSION, i as RUNTIME_MEMORY_LIMITS, n as RUNTIME_BRANCH_NAME_PATTERN, o as parseRuntimeBranches, r as RUNTIME_ENTRY_DELIMITER, t as RUNTIME_BRANCH_NAME_MAX } from "./contracts-B6vRCw3C.js";
-export { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, parseRuntimeBranches };
+import { _ as summarizeRuntimeMemories, a as RUNTIME_ENTRY_DELIMITER, c as RUNTIME_LOCK_STALE_MS, d as RUNTIME_MEMORY_LIMIT_MAX_BYTES, f as RUNTIME_MEMORY_VERSION, g as runtimeProjection, h as runtimeBytes, i as RUNTIME_DIRECTORY, l as RUNTIME_MEMORIES_FILE, m as parseRuntimeBranches, n as RUNTIME_BRANCH_NAME_MAX, o as RUNTIME_ENTRY_MAX_BYTES, p as RUNTIME_PROJECTION_FILES, r as RUNTIME_BRANCH_NAME_PATTERN, s as RUNTIME_LOCK_FILE, t as RUNTIME_ARCHIVE_DIRECTORY, u as RUNTIME_MEMORY_LIMITS } from "./contracts-DycwaUv_.js";
+export { RUNTIME_ARCHIVE_DIRECTORY, RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_DIRECTORY, RUNTIME_ENTRY_DELIMITER, RUNTIME_ENTRY_MAX_BYTES, RUNTIME_LOCK_FILE, RUNTIME_LOCK_STALE_MS, RUNTIME_MEMORIES_FILE, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_LIMIT_MAX_BYTES, RUNTIME_MEMORY_VERSION, RUNTIME_PROJECTION_FILES, parseRuntimeBranches, runtimeBytes, runtimeProjection, summarizeRuntimeMemories };

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches } from "./contracts.js";
+import { RUNTIME_ARCHIVE_DIRECTORY, RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_DIRECTORY, RUNTIME_ENTRY_DELIMITER, RUNTIME_ENTRY_MAX_BYTES, RUNTIME_LOCK_FILE, RUNTIME_LOCK_STALE_MS, RUNTIME_MEMORIES_FILE, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_LIMIT_MAX_BYTES, RUNTIME_MEMORY_VERSION, RUNTIME_PROJECTION_FILES, RuntimeMemoriesSummary, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches, runtimeBytes, runtimeProjection, summarizeRuntimeMemories } from "./contracts.js";
 import z from "@deepseek-ai/schemastery";
 import { MemorySourceDefinition } from "dsh-mnemon/contracts";
 import { Context } from "@deepseek-ai/cordis";
@@ -21,4 +21,4 @@ declare const inject: string[];
 declare const memoryPlugin: import("dsh-mnemon/extension-sdk").MemoryPluginDescriptor;
 declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { Config, type RUNTIME_BRANCH_NAME_MAX, type RUNTIME_BRANCH_NAME_PATTERN, type RUNTIME_ENTRY_DELIMITER, type RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_SOURCE, type RUNTIME_MEMORY_VERSION, type RuntimeMemoryAction, type RuntimeMemoryCompactedEntry, type RuntimeMemoryEntry, type RuntimeMemoryEntryOrigin, type RuntimeMemoryImportance, type RuntimeMemoryLimits, type RuntimeMemoryMaintenancePlan, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type RuntimeMemoryTargetView, type RuntimeMemoryUsage, apply, createRuntimeMemorySource, inject, memoryPlugin, name, type parseRuntimeBranches };
+export { Config, type RUNTIME_ARCHIVE_DIRECTORY, type RUNTIME_BRANCH_NAME_MAX, type RUNTIME_BRANCH_NAME_PATTERN, type RUNTIME_DIRECTORY, type RUNTIME_ENTRY_DELIMITER, type RUNTIME_ENTRY_MAX_BYTES, type RUNTIME_LOCK_FILE, type RUNTIME_LOCK_STALE_MS, type RUNTIME_MEMORIES_FILE, type RUNTIME_MEMORY_LIMITS, type RUNTIME_MEMORY_LIMIT_MAX_BYTES, RUNTIME_MEMORY_SOURCE, type RUNTIME_MEMORY_VERSION, type RUNTIME_PROJECTION_FILES, type RuntimeMemoriesSummary, type RuntimeMemoryAction, type RuntimeMemoryCompactedEntry, type RuntimeMemoryEntry, type RuntimeMemoryEntryOrigin, type RuntimeMemoryImportance, type RuntimeMemoryLimits, type RuntimeMemoryMaintenancePlan, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type RuntimeMemoryTargetView, type RuntimeMemoryUsage, apply, createRuntimeMemorySource, inject, memoryPlugin, name, type parseRuntimeBranches, type runtimeBytes, type runtimeProjection, type summarizeRuntimeMemories };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { i as RUNTIME_MEMORY_LIMITS, l as MAX_RUNTIME_MEMORY_LIMIT_BYTES, n as RUNTIME_BRANCH_NAME_PATTERN, o as parseRuntimeBranches, r as RUNTIME_ENTRY_DELIMITER } from "./contracts-B6vRCw3C.js";
+import { a as RUNTIME_ENTRY_DELIMITER, b as MAX_RUNTIME_MEMORY_LIMIT_BYTES, g as runtimeProjection, h as runtimeBytes, i as RUNTIME_DIRECTORY, l as RUNTIME_MEMORIES_FILE, m as parseRuntimeBranches, o as RUNTIME_ENTRY_MAX_BYTES, p as RUNTIME_PROJECTION_FILES, r as RUNTIME_BRANCH_NAME_PATTERN, s as RUNTIME_LOCK_FILE, t as RUNTIME_ARCHIVE_DIRECTORY, u as RUNTIME_MEMORY_LIMITS } from "./contracts-DycwaUv_.js";
 import { createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, installMemory, memoryConfigurationDigest, memoryInputRecord, memoryInputStringArray, memoryInputText, truncateMemoryText } from "dsh-mnemon/extension-sdk";
 import { homedir } from "node:os";
 import { basename, isAbsolute, join } from "node:path";
@@ -75,9 +75,7 @@ function resolveGitBranch(cwd) {
 //#endregion
 //#region src/controller.ts
 const LOCK_TIMEOUT_MS = 5e3;
-const LOCK_STALE_MS = 3e4;
 const LOCK_RETRY_MS = 20;
-const MAX_ENTRY_BYTES = 8192;
 /** Append to a file that is not a symbolic link; the open fails on one. */
 function appendWithoutLinks(path, text) {
 	const descriptor = openSync(path, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT | (constants.O_NOFOLLOW ?? 0), 384);
@@ -147,7 +145,7 @@ function normalizeContent(value, field) {
 	if (content === "") throw new Error(`${field} is required`);
 	if (content.includes("§")) throw new Error(`${field} must not contain the reserved § entry delimiter`);
 	const bytes = Buffer.byteLength(content, "utf8");
-	if (bytes > MAX_ENTRY_BYTES) throw new Error(`${field} is too large (${bytes} bytes; max ${MAX_ENTRY_BYTES})`);
+	if (bytes > 8192) throw new Error(`${field} is too large (${bytes} bytes; max ${RUNTIME_ENTRY_MAX_BYTES})`);
 	return content;
 }
 function parseOrigin(value) {
@@ -177,14 +175,6 @@ function parseEntry(value) {
 		...origin === void 0 ? {} : { origin }
 	};
 }
-function byteCount(entries, target) {
-	const content = entries.filter((entry) => entry.target === target).map((entry) => entry.content).join(RUNTIME_ENTRY_DELIMITER);
-	return Buffer.byteLength(content, "utf8");
-}
-function markdown(entries, target) {
-	const content = entries.filter((entry) => entry.target === target).map((entry) => entry.content).join(RUNTIME_ENTRY_DELIMITER);
-	return content === "" ? "" : `${content}\n`;
-}
 function age(timestamp, projectedAt) {
 	const time = Date.parse(timestamp);
 	if (!Number.isFinite(time)) return "unknown";
@@ -193,12 +183,20 @@ function age(timestamp, projectedAt) {
 }
 /** Prompt-only annotations; stored content, matching and capacity stay unchanged. */
 function contextMarkdown(entries, target, projectedAt) {
-	return entries.filter((entry) => entry.target === target).map((entry) => `[importance=${entry.importance}; created=${age(entry.created_at, projectedAt)}; updated=${age(entry.updated_at, projectedAt)}]\n${entry.content}`).join(RUNTIME_ENTRY_DELIMITER);
+	return entries.filter((entry) => entry.target === target).map((entry) => {
+		const annotations = [];
+		if (entry.importance !== "normal") annotations.push(`importance=${entry.importance}`);
+		for (const [name, timestamp] of [["created", entry.created_at], ["updated", entry.updated_at]]) {
+			const elapsed = age(timestamp, projectedAt);
+			if (elapsed !== "0d") annotations.push(`${name}=${elapsed}`);
+		}
+		return `${annotations.length === 0 ? "" : `[${annotations.join("; ")}]\n`}${entry.content}`;
+	}).join(RUNTIME_ENTRY_DELIMITER);
 }
 function revision(file) {
 	return createHash("sha256").update(JSON.stringify(file)).digest("hex");
 }
-function prepareMutation(before, request, now) {
+function prepareMutation(before, request, now, preserveImportance = false) {
 	if (!isTarget(request.target)) throw new Error("target must be memory or user");
 	if (![
 		"add",
@@ -250,12 +248,19 @@ function prepareMutation(before, request, now) {
 	const previous = entries[index];
 	const compactableEntries = entries.filter((entry, entryIndex) => entry.target === request.target && entryIndex !== index);
 	if (request.action === "replace") {
+		const ranks = {
+			low: 0,
+			normal: 1,
+			critical: 2
+		};
+		const requested = request.importance ?? previous.importance;
+		const importance = preserveImportance && ranks[requested] < ranks[previous.importance] ? previous.importance : requested;
 		const content = normalizeContent(request.content, "content");
 		const pendingEntry = {
 			...previous,
 			content,
 			updated_at: now,
-			importance: request.importance ?? previous.importance
+			importance
 		};
 		if (branchScope !== void 0) {
 			if (branchScope.length === 0) delete pendingEntry.branches;
@@ -269,7 +274,7 @@ function prepareMutation(before, request, now) {
 			pendingEntry,
 			excludedEntry: previous,
 			fields: {
-				message: "Entry replaced.",
+				message: importance === requested ? "Entry replaced." : "Entry replaced; original importance preserved.",
 				replaced: {
 					from: previous.content,
 					to: content
@@ -365,14 +370,14 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 			memory: limits.memory,
 			user: limits.user
 		};
-		this.directory = join(runner.effectiveDataDir(), "runtime");
-		this.sourcePath = join(this.directory, "memories.json");
-		this.memoryPath = join(this.directory, "MEMORY.md");
-		this.localUserPath = join(this.directory, "USER.md");
-		this.lockPath = join(this.directory, ".memories.lock");
-		this.archivePath = join(this.directory, "archived", "MEMORY.md");
-		this.archiveSourcePath = join(this.directory, "archived", "memories.jsonl");
-		const userDirectory = userRunner === void 0 ? this.directory : join(userRunner.effectiveDataDir(), "runtime");
+		this.directory = join(runner.effectiveDataDir(), RUNTIME_DIRECTORY);
+		this.sourcePath = join(this.directory, RUNTIME_MEMORIES_FILE);
+		this.memoryPath = join(this.directory, RUNTIME_PROJECTION_FILES.memory);
+		this.localUserPath = join(this.directory, RUNTIME_PROJECTION_FILES.user);
+		this.lockPath = join(this.directory, RUNTIME_LOCK_FILE);
+		this.archivePath = join(this.directory, RUNTIME_ARCHIVE_DIRECTORY, "MEMORY.md");
+		this.archiveSourcePath = join(this.directory, RUNTIME_ARCHIVE_DIRECTORY, "memories.jsonl");
+		const userDirectory = userRunner === void 0 ? this.directory : join(userRunner.effectiveDataDir(), RUNTIME_DIRECTORY);
 		this.userController = userDirectory === this.directory || userRunner === void 0 ? void 0 : new RuntimeMemoryController(userRunner, now, this.limits);
 		this.userPath = this.userController?.userPath ?? this.localUserPath;
 		this.userSourcePath = this.userController?.sourcePath ?? this.sourcePath;
@@ -424,8 +429,6 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 				}
 			}
 		};
-		const storeMemory = this.targetView(entries, "memory");
-		const storeUser = this.targetView(entries, "user");
 		const visibleEntries = branchScope === void 0 ? entries : entries.filter((entry) => entry.target === "user" || entryMatchesBranch(entry, branchScope));
 		const branchLine = branchScope === void 0 ? "" : `\nGit branch: ${branchScope}${local.hidden > 0 ? ` (${local.hidden} branch-scoped entr${local.hidden === 1 ? "y" : "ies"} hidden)` : ""}`;
 		return {
@@ -436,15 +439,14 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 			})),
 			totalEntries: entries.length,
 			text: `MNEMON RUNTIME MEMORY SNAPSHOT
-Revision: ${snapshot.revision}${branchLine}
-Metadata lines are annotations; created/updated are ages at projection in whole days (future/unknown for future/invalid timestamps). Current instructions win. For old_text/oldText, use entry content only.
+Entry annotations default to importance=normal and ages=0d (whole days at projection; future/unknown for future/invalid timestamps). Current instructions win. For old_text/oldText, use entry content only.${branchLine}
 
-Contents of USER.md (user profile; entries: ${visibleUser.entryCount}; UTF-8 bytes: ${storeUser.used}/${storeUser.limit})
+USER.md (user profile)
 <runtime-memory-file name="USER.md">
 ${user || "(empty)"}
 </runtime-memory-file>
 
-Contents of MEMORY.md (working reference; entries: ${visibleMemory.entryCount}; UTF-8 bytes: ${storeMemory.used}/${storeMemory.limit})
+MEMORY.md (working reference)
 <runtime-memory-file name="MEMORY.md">
 ${memory || "(empty)"}
 </runtime-memory-file>`
@@ -475,20 +477,20 @@ ${memory || "(empty)"}
 			};
 		});
 	}
-	mutate(request) {
-		if (request.target === "user" && this.userController !== void 0) return this.userController.mutate(request);
-		const operation = this.queue.then(() => this.withLock(() => this.mutateLocked(request)));
+	mutate(request, options = {}) {
+		if (request.target === "user" && this.userController !== void 0) return this.userController.mutate(request, options);
+		const operation = this.queue.then(() => this.withLock(() => this.mutateLocked(request, options.preserveImportance)));
 		this.queue = operation.catch(() => void 0);
 		return operation;
 	}
 	/** Resolve exactly which committed entries survive a blocked mutation and are safe to compact. */
-	planMaintenance(request) {
-		if (request.target === "user" && this.userController !== void 0) return this.userController.planMaintenance(request);
+	planMaintenance(request, options = {}) {
+		if (request.target === "user" && this.userController !== void 0) return this.userController.planMaintenance(request, options);
 		const operation = this.queue.then(() => this.withLock(() => {
 			const file = this.readSource();
-			const prepared = prepareMutation(file.entries, request, this.now().toISOString());
-			const used = byteCount(file.entries, request.target);
-			const projected = byteCount(prepared.projectedEntries, request.target);
+			const prepared = prepareMutation(file.entries, request, this.now().toISOString(), options.preserveImportance);
+			const used = runtimeBytes(file.entries, request.target);
+			const projected = runtimeBytes(prepared.projectedEntries, request.target);
 			const limit = this.limits[request.target];
 			return {
 				revision: revision(file),
@@ -516,13 +518,13 @@ ${memory || "(empty)"}
 	* local archive first, so a limit with no Memory Space to archive into never loses memory.
 	*/
 	compactAndMutate(expectedRevision, request, compacted, maxCompactedBytes, options = {}) {
-		if (request.target === "user" && this.userController !== void 0) return this.userController.compactAndMutate(expectedRevision, request, compacted, maxCompactedBytes);
+		if (request.target === "user" && this.userController !== void 0) return this.userController.compactAndMutate(expectedRevision, request, compacted, maxCompactedBytes, options);
 		const operation = this.queue.then(() => this.withLock(() => {
 			const file = this.readSource();
 			const beforeRevision = revision(file);
 			if (beforeRevision !== expectedRevision) throw new RuntimeMemoryConflictError();
 			const now = this.now().toISOString();
-			const prepared = prepareMutation(file.entries, request, now);
+			const prepared = prepareMutation(file.entries, request, now, options.preserveImportance);
 			const compactedByteBudget = maxCompactedBytes ?? this.limits[request.target];
 			if (!Number.isInteger(compactedByteBudget) || compactedByteBudget < 0 || compactedByteBudget > this.limits[request.target]) throw new Error("compaction byte budget is invalid");
 			if (!prepared.changed) return this.result(request.target, prepared.projectedEntries, prepared.fields);
@@ -532,9 +534,9 @@ ${memory || "(empty)"}
 			const fitted = packCompactionCandidates(replacements, request.target, compactedByteBudget);
 			const targetEntries = [...fitted, ...prepared.pendingEntry === void 0 ? [] : [prepared.pendingEntry]];
 			const entries = [...file.entries.filter((entry) => entry.target !== request.target), ...targetEntries];
-			const used = byteCount(entries, request.target);
+			const used = runtimeBytes(entries, request.target);
 			const limit = this.limits[request.target];
-			if (used > limit) throw new RuntimeMemoryCapacityError(request.target, byteCount(file.entries, request.target), used, limit);
+			if (used > limit) throw new RuntimeMemoryCapacityError(request.target, runtimeBytes(file.entries, request.target), used, limit);
 			const next = {
 				version: 1,
 				entries
@@ -556,7 +558,7 @@ ${memory || "(empty)"}
 	}
 	/** Append entries to the local archive: JSON Lines to restore from, and Markdown to read. */
 	archiveLocally(entries, fromRevision, archivedAt) {
-		const directory = join(this.directory, "archived");
+		const directory = join(this.directory, RUNTIME_ARCHIVE_DIRECTORY);
 		mkdirSync(directory, {
 			recursive: true,
 			mode: 448
@@ -590,13 +592,13 @@ ${memory || "(empty)"}
 			this.persist(file);
 		});
 	}
-	mutateLocked(request) {
+	mutateLocked(request, preserveImportance = false) {
 		const file = this.readSource();
-		const prepared = prepareMutation(file.entries, request, this.now().toISOString());
+		const prepared = prepareMutation(file.entries, request, this.now().toISOString(), preserveImportance);
 		if (!prepared.changed) return this.result(request.target, prepared.projectedEntries, prepared.fields);
-		const used = byteCount(prepared.projectedEntries, request.target);
+		const used = runtimeBytes(prepared.projectedEntries, request.target);
 		const limit = this.limits[request.target];
-		if (used > limit) throw new RuntimeMemoryCapacityError(request.target, byteCount(file.entries, request.target), used, limit);
+		if (used > limit) throw new RuntimeMemoryCapacityError(request.target, runtimeBytes(file.entries, request.target), used, limit);
 		this.persist({
 			version: 1,
 			entries: prepared.projectedEntries
@@ -610,7 +612,7 @@ ${memory || "(empty)"}
 			target,
 			entryCount: entries.filter((entry) => entry.target === target).length,
 			usage: {
-				used: byteCount(entries, target),
+				used: runtimeBytes(entries, target),
 				limit: this.limits[target]
 			},
 			...fields.added === void 0 ? {} : { added: fields.added },
@@ -622,7 +624,7 @@ ${memory || "(empty)"}
 		return {
 			target,
 			entryCount: entries.filter((entry) => entry.target === target).length,
-			used: byteCount(entries, target),
+			used: runtimeBytes(entries, target),
 			limit: this.limits[target],
 			markdownPath: target === "memory" ? this.memoryPath : this.userPath
 		};
@@ -667,8 +669,8 @@ ${memory || "(empty)"}
 		});
 		const nonce = `${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}`;
 		const writes = [
-			[this.localUserPath, markdown(file.entries, "user")],
-			[this.memoryPath, markdown(file.entries, "memory")],
+			[this.localUserPath, runtimeProjection(file.entries, "user")],
+			[this.memoryPath, runtimeProjection(file.entries, "memory")],
 			[this.sourcePath, `${JSON.stringify(file, null, 2)}\n`]
 		];
 		const temporaries = writes.map(([path]) => join(this.directory, `.${basename(path)}.${nonce}.tmp`));
@@ -684,7 +686,7 @@ ${memory || "(empty)"}
 	}
 	repairProjections(file) {
 		for (const [path, target] of [[this.localUserPath, "user"], [this.memoryPath, "memory"]]) {
-			const expected = markdown(file.entries, target);
+			const expected = runtimeProjection(file.entries, target);
 			let current;
 			try {
 				current = readFileSync(path, "utf8");
@@ -712,7 +714,7 @@ ${memory || "(empty)"}
 		} catch (error) {
 			if ((isRecord(error) && typeof error.code === "string" ? error.code : void 0) !== "EEXIST") throw error;
 			try {
-				if (Date.now() - statSync(this.lockPath).mtimeMs > LOCK_STALE_MS) {
+				if (Date.now() - statSync(this.lockPath).mtimeMs > 3e4) {
 					rmSync(this.lockPath, { force: true });
 					continue;
 				}
@@ -891,7 +893,7 @@ function createRuntimeMemorySource(config = {}) {
 					if (request.mode === "read") {
 						let value;
 						if (request.operation === "snapshot") value = controller.snapshot();
-						else if (request.operation === "maintenance-plan") value = await controller.planMaintenance(runtimeMutation(request.input));
+						else if (request.operation === "maintenance-plan") value = await controller.planMaintenance(runtimeMutation(request.input), { preserveImportance: input.preserveImportance === true });
 						else throw new Error("unsupported Runtime management read operation: " + request.operation);
 						return {
 							revision: controller.snapshot().revision,
@@ -900,7 +902,7 @@ function createRuntimeMemorySource(config = {}) {
 					}
 					if (!request.confirmed) throw new Error("Runtime management mutation requires explicit confirmation");
 					let result;
-					if (request.operation === "mutate") result = await controller.mutate(runtimeMutation(request.input));
+					if (request.operation === "mutate") result = await controller.mutate(runtimeMutation(request.input), { preserveImportance: input.preserveImportance === true });
 					else if (request.operation === "compact-and-mutate") {
 						if (!Array.isArray(input.compacted)) throw new Error("compacted must be an array");
 						const compacted = input.compacted.map((value) => {
@@ -914,7 +916,10 @@ function createRuntimeMemorySource(config = {}) {
 							};
 						});
 						if (input.archive !== void 0 && input.archive !== "local") throw new Error("archive must be \"local\" when given");
-						result = await controller.compactAndMutate(memoryInputText(input.revision, "revision", 300), runtimeMutation(input.mutation), compacted, typeof input.maxBytes === "number" ? input.maxBytes : void 0, input.archive === "local" ? { archive: "local" } : {});
+						result = await controller.compactAndMutate(memoryInputText(input.revision, "revision", 300), runtimeMutation(input.mutation), compacted, typeof input.maxBytes === "number" ? input.maxBytes : void 0, {
+							...input.archive === "local" ? { archive: "local" } : {},
+							preserveImportance: input.preserveImportance === true
+						});
 					} else throw new Error("unsupported Runtime management mutation operation: " + request.operation);
 					return {
 						revision: controller.snapshot().revision,
@@ -922,7 +927,7 @@ function createRuntimeMemorySource(config = {}) {
 					};
 				},
 				async mutate(request) {
-					const result = await controller.mutate(runtimeMutation(request.input));
+					const result = await controller.mutate(runtimeMutation(request.input), { preserveImportance: true });
 					const revision = controller.snapshot().revision;
 					return createMemoryMutationReceipt(request.view.id, request.offer.id, context.sourceInstanceKey, revision, result, "committed");
 				}

package/lib/types/contracts.d.ts

@@ -96,6 +96,8 @@ export interface RuntimeMemoryLimits {
     readonly user: number;
 }
 export declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
+/** The largest limit, in UTF-8 bytes, either target's file may be given. */
+export declare const RUNTIME_MEMORY_LIMIT_MAX_BYTES: number;
 /** The longest git branch name a scope may hold. */
 export declare const RUNTIME_BRANCH_NAME_MAX = 128;
 /** The characters a git branch name in a scope may use. */
@@ -106,3 +108,40 @@ export declare const RUNTIME_BRANCH_NAME_PATTERN: RegExp;
  * of breaking the projection that reads it.
  */
 export declare function parseRuntimeBranches(value: unknown): string[] | undefined;
+/** The Runtime Source's directory under a storage root. */
+export declare const RUNTIME_DIRECTORY = "runtime";
+/** The entries themselves, the source of truth the projections are written from. */
+export declare const RUNTIME_MEMORIES_FILE = "memories.json";
+/** Each target's projection: its entries' plain content, the file a person reads. */
+export declare const RUNTIME_PROJECTION_FILES: {
+    readonly user: "USER.md";
+    readonly memory: "MEMORY.md";
+};
+/** Created exclusively while the files above are read or written; whoever copies them takes it too. */
+export declare const RUNTIME_LOCK_FILE = ".memories.lock";
+/** A lock file older than this was left by a process that stopped, and may be taken over. */
+export declare const RUNTIME_LOCK_STALE_MS = 30000;
+/** The local archive of entries that left MEMORY.md while no Memory Space could take them (#336). */
+export declare const RUNTIME_ARCHIVE_DIRECTORY = "archived";
+/** The longest content one entry may hold, in UTF-8 bytes. */
+export declare const RUNTIME_ENTRY_MAX_BYTES: number;
+type RuntimeEntryText = Pick<RuntimeMemoryEntry, 'target' | 'content'>;
+/** The UTF-8 bytes one target's entries take against its limit: their contents joined by the delimiter. */
+export declare function runtimeBytes(entries: ReadonlyArray<RuntimeEntryText>, target: RuntimeMemoryTarget): number;
+/** One target's projection file, USER.md or MEMORY.md, exactly as the Runtime Source writes it. */
+export declare function runtimeProjection(entries: ReadonlyArray<RuntimeEntryText>, target: RuntimeMemoryTarget): string;
+/** What a stored memories.json holds, counted without judging each entry. */
+export interface RuntimeMemoriesSummary {
+    /** Whether the file has an entry list at all. Without one, every count is 0. */
+    valid: boolean;
+    /** Every entry that is an object, whatever its target. */
+    entries: number;
+    user: number;
+    memory: number;
+}
+/**
+ * Count the entries of a parsed memories.json for a read-only inventory. It never throws: a file
+ * without an entry list is not `valid`, and a malformed entry is counted or skipped, never refused.
+ */
+export declare function summarizeRuntimeMemories(value: unknown): RuntimeMemoriesSummary;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-runtime",
-  "version": "0.5.14",
+  "version": "0.5.16",
   "description": "Self-contained runtime Source for Composable View Memory.",
   "license": "MIT",
   "type": "module",
@@ -55,12 +55,12 @@
     "react": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.26",
+    "dsh-mnemon": "^0.5.35",
     "jsdom": "^26.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
@@ -84,9 +84,9 @@
     "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-symbol": "^2.0.1",
     "shiki": "^4.3.1",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-code-language": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-rc.2",
     "diff": "^9.0.0",
     "immer": "^10.1.1",
     "simple-icons": "16.31.0",

package/presentation/page.module.css

@@ -11,7 +11,7 @@
 .runtimeComposerActions { display: flex; align-items: flex-end; justify-content: flex-end; gap: 8px; margin-top: 12px; }
 .runtimeComposerActions label { display: grid; gap: 6px; color: var(--mn-muted); font-size: 12px; font-weight: 500; line-height: 18px; }
 .runtimeChoice button { min-width: 136px; }
-.runtimeReadOnly { margin-bottom: 12px; padding: 8px 12px; border-radius: var(--dsw-radius-md); color: var(--mn-muted); background: var(--mn-fill); font-size: 12px; line-height: 18px; }
+.runtimeReadOnly { margin-bottom: 12px; padding: 8px 12px; border-radius: var(--dsw-radius-md); color: var(--mn-muted); background: var(--mn-block-fill, var(--mn-fill)); font-size: 12px; line-height: 18px; }
 .runtimeSummaryGrid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-bottom: 12px; }
 .runtimeSummaryCard { min-width: 0; border: .5px solid var(--mn-card-line); border-radius: var(--dsw-radius-lg); }
 .runtimeBrowser { overflow: hidden; border: .5px solid var(--mn-card-line); border-radius: var(--dsw-radius-lg); }

package/lib/contracts-B6vRCw3C.js

@@ -1,32 +0,0 @@
-//#region src/defaults.ts
-const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES = 10240;
-const DEFAULT_RUNTIME_USER_LIMIT_BYTES = 4096;
-const MAX_RUNTIME_MEMORY_LIMIT_BYTES = 1048576;
-//#endregion
-//#region src/contracts.ts
-const RUNTIME_MEMORY_VERSION = 1;
-const RUNTIME_ENTRY_DELIMITER = "\n§\n";
-const RUNTIME_MEMORY_LIMITS = {
-	memory: DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES,
-	user: DEFAULT_RUNTIME_USER_LIMIT_BYTES
-};
-/** The longest git branch name a scope may hold. */
-const RUNTIME_BRANCH_NAME_MAX = 128;
-/** The characters a git branch name in a scope may use. */
-const RUNTIME_BRANCH_NAME_PATTERN = /^[A-Za-z0-9._/-]+$/u;
-/**
-* Read a stored branch scope. Absent or malformed data reads as no scope, so an entry that
-* a hand edit or another installation left malformed is projected on every branch instead
-* of breaking the projection that reads it.
-*/
-function parseRuntimeBranches(value) {
-	if (!Array.isArray(value)) return void 0;
-	const branches = [];
-	for (const item of value) {
-		if (typeof item !== "string" || item === "" || item.length > 128 || !RUNTIME_BRANCH_NAME_PATTERN.test(item)) return void 0;
-		branches.push(item);
-	}
-	return branches;
-}
-//#endregion
-export { RUNTIME_MEMORY_VERSION as a, DEFAULT_RUNTIME_USER_LIMIT_BYTES as c, RUNTIME_MEMORY_LIMITS as i, MAX_RUNTIME_MEMORY_LIMIT_BYTES as l, RUNTIME_BRANCH_NAME_PATTERN as n, parseRuntimeBranches as o, RUNTIME_ENTRY_DELIMITER as r, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES as s, RUNTIME_BRANCH_NAME_MAX as t };